SQLITE_LOCKED: Datenbanktabelle ist gesperrt
Ein Schreibvorgang konnte aufgrund eines Konflikts innerhalb derselben Verbindung oder des geteilten Caches nicht fortgesetzt werden, zum Beispiel das Löschen einer Tabelle, die eine Anweisung noch liest.
- Ergebniscode
SQLITE_LOCKED- Name
6- Kategorie
- Primäre Ergebniscodes
Was es bedeutet
SQLITE_LOCKED (6) bedeutet, dass der Konflikt innerhalb deiner eigenen Verbindung oder zwischen Verbindungen besteht, die einen Cache teilen, und nicht mit einem anderen Prozess. Das klassische Beispiel aus der SQLite-Dokumentation ist ein DROP TABLE während eine andere Anweisung auf derselben Verbindung diese Tabelle noch liest: beim Löschen würde die Tabelle dem Leser unter den Füßen weggezogen.
Dies unterscheidet sich von SQLITE_BUSY, was bedeutet, dass eine andere Verbindung, üblicherweise in einem anderen Prozess, eine Sperre hält. Warten behebt SQLITE_LOCKED; das Beenden der anderen Anweisung schon.
Häufige Ursachen
- Läuft
DROP TABLE,ALTER TABLEoder Ähnliches, während eineSELECTin derselben Verbindung nicht bis zum Ende ausgeführt oder zurückgesetzt wurde. - In manchen Fällen Schreiben in eine Tabelle, während eine Abfrage mit einer nicht abgeschlossenen Anweisung darüber iteriert.
- Shared-Cache-Modus, bei dem eine Verbindung, die eine Tabelle ändert, andere blockiert, die denselben Cache teilen (
SQLITE_LOCKED_SHAREDCACHE).
Wie du es behebst
-
Schließe jede Anweisung ab, setze sie zurück oder finalisiere sie, bevor du das Schema änderst. In Python: erst alle Zeilen abrufen oder den Cursor schließen.
-
Lies die benötigten Zeilen zuerst in den Speicher, und führe dann die DDL oder die Schreibvorgänge aus.
-- read first SELECT id FROM staging; -- then, after the reader is done: DROP TABLE staging;
-
Vermeide den Shared-Cache-Modus, außer du brauchst ihn. SQLite rät davon ab; mit dem WAL-Modus bekommst du üblicherweise gleichzeitige Leser.
Fragen
Wird ein Busy-Timeout SQLITE_LOCKED beheben?
Nein. Der Busy-Handler ist für Konflikte mit anderen Verbindungen da (SQLITE_BUSY). SQLITE_LOCKED ist ein Konflikt innerhalb deiner eigenen Verbindung oder des Shared Cache, also besteht die Lösung darin, die störende Anweisung zu beenden oder zurückzusetzen.
Zugehörige Fehler
Weitere Fehler bei primären Ergebniscodes
SQLITE_ERRORSQL-LogikfehlerSQLITE_PERMZugriffsberechtigung verweigertSQLITE_ABORTAbfrage abgebrochenSQLITE_NOMEMkein Speicher mehrSQLITE_READONLYVersuch, in eine schreibgeschützte Datenbank zu schreibenSQLITE_INTERRUPTunterbrochenSQLITE_IOERRFestplatten-I/O-FehlerSQLITE_CORRUPTDatenbank-Disk-Image ist beschädigt
Der Code und der Meldungstext stammen aus der SQLite-Dokumentation zu Ergebnis- und Fehlercodes. Durchstöbere die vollständige SQLite-Fehlerliste oder Jeden Datenbankfehler durchsuchen.
Arbeiten mit SQLite in SQLly
Ein nativer SQL-Client für macOS, Windows und Linux mit schemabewusstem IntelliSense, Guardrails für riskante Anweisungen und klaren Fehlermeldungen, für SQLite und die anderen Datenbanken, mit denen du arbeitest.