SQLITE_BUSY : la base de données est verrouillée
Une autre connexion détient un verrou dont SQLite a besoin, généralement un processus en écriture dans une autre application. Définissez un délai d'occupation (busy timeout), maintenez les transactions d'écriture courtes, ou passez en mode WAL.
- Code de résultat
SQLITE_BUSY- Nom
5- Catégorie
- Codes de résultat principaux
Ce que cela signifie
SQLite permet un seul écrivain à la fois par fichier de base de données. Lorsqu'une connexion a besoin d'un verrou que détient une autre connexion (dans le même processus ou dans un autre), l'appel échoue avec SQLITE_BUSY et le message database is locked, sauf si un gestionnaire d'occupation (busy handler) est défini, auquel cas SQLite réessaie d'abord jusqu'au délai défini.
Par défaut, il n'y a pas de busy handler (gestionnaire d'occupation), donc l'échec est immédiat. En mode rollback-journal, les lecteurs empêchent aussi un rédacteur de valider, et un rédacteur bloque les nouveaux lecteurs pendant qu'il valide ; le mode WAL permet aux lecteurs et à un rédacteur de travailler en même temps.
Causes courantes
- Deux processus ou threads écrivent dans la même base de données en même temps, sans busy timeout défini.
- Une longue transaction d’écriture (ou un
BEGINqui n’a jamais été validée) conserve le verrou pendant que les autres attendent. - Une transaction de lecture commencée avec
BEGIN DEFERREDtente de passer à une écriture pendant qu’une autre connexion écrit ; en mode WAL, cela renvoieSQLITE_BUSY_SNAPSHOTet attendre ne résoudra rien. - Un curseur ouvert ou une instruction non terminée dans votre propre programme maintient une transaction de lecture ouverte.
- Le fichier de base de données se trouve sur un système de fichiers réseau dont le verrouillage ne fonctionne pas de manière fiable.
Comment le corriger
-
Définissez un délai d’attente pour que SQLite patiente et réessaie au lieu d’échouer immédiatement. La plupart des interfaces le proposent (celle de Python
sqlite3attend 5 secondes par défaut ; augmentez ce délai avecsqlite3.connect(path, timeout=30)). En SQL :PRAGMA busy_timeout = 5000; -- milliseconds
-
Passez la base de données en mode WAL (journal en écriture anticipée), afin que les lecteurs ne bloquent plus l'écrivain et que l'écrivain ne bloque plus les lecteurs.
PRAGMA journal_mode = WAL;
-
Démarrez les transactions d'écriture avec
BEGIN IMMEDIATE, qui prend le verrou d'écriture dès le départ. Une connexion occupée attend alors àBEGIN(où le délai s'applique) au lieu d'échouer en cours de route.BEGIN IMMEDIATE; UPDATE counters SET n = n + 1 WHERE name = 'visits'; COMMIT;
-
Gardez les transactions courtes, validez-les rapidement et terminez ou réinitialisez chaque instruction (fermez les curseurs) afin qu'aucune connexion ne détienne un verrou plus longtemps que nécessaire.
-
Conservez la base de données sur un disque local, pas sur un partage réseau.
Reproduisez-le en toute sécurité
Utilisez deux connexions séparées vers le même fichier de base de données temporaire.
-- Connection 1 (for example the sqlite3 shell): BEGIN IMMEDIATE; INSERT INTO t VALUES (1); -- Connection 2, same file, no busy timeout: INSERT INTO t VALUES (2); -- Runtime error: database is locked (5)
Questions
Quelle est la différence entre SQLITE_BUSY et SQLITE_LOCKED ?
SQLITE_BUSY signifie qu'une autre connexion à la base de données, généralement dans un autre processus, détient un verrou en conflit. SQLITE_LOCKED signifie que le conflit se trouve à l'intérieur de votre propre connexion ou entre des connexions partageant un cache, par exemple en supprimant une table alors qu'une instruction est encore en train de la lire.
Le mode WAL fait-il disparaître l’erreur « database is locked » ?
Il supprime la plupart des conflits lecteur-écrivain, mais il n'y a toujours qu'un seul écrivain à la fois, donc les écritures concurrentes ont toujours besoin d'un délai d'attente busy.
Erreurs liées
SQLITE_LOCKEDla table de la base de données est verrouilléeSQLITE_BUSY_SNAPSHOTlecture obsolète ne peut pas devenir une écritureSQLITE_BUSY_TIMEOUTexpiration du verrou de fichier bloquant55P03PostgreSQL : verrou non disponible1205MySQL : Délai d'attente de verrou dépassé1222SQL Server : délai d'attente de la demande de verrou dépassé
Plus d'erreurs de codes de résultat principaux
SQLITE_ERRORErreur de logique SQLSQLITE_PERMpermission d’accès refuséeSQLITE_ABORTrequête avortéeSQLITE_NOMEMManque de mémoireSQLITE_READONLYtentative d'écriture dans une base de données en lecture seuleSQLITE_INTERRUPTinterrompuSQLITE_IOERRerreur d'E/S disqueSQLITE_CORRUPTl'image disque de la base de données est corrompue
Le code et le texte du message sont issus de documentation des codes de résultat et d'erreur SQLite. Parcourir la liste complète Liste des erreurs SQLite ou Rechercher toutes les erreurs de base de données.
Travailler sur SQLite dans SQLly
Un client SQL natif pour macOS, Windows et Linux avec IntelliSense conscient du schéma, des garde-fous pour les instructions risquées et des messages d'erreur clairs, pour SQLite et les autres bases de données que vous utilisez.