// SQLite-Fehlerreferenz

SQLITE_BUSY_TIMEOUT: Zeitüberschreitung bei blockierender Dateisperre

Eine blockierende POSIX-Dateisperren-Anfrage in der VFS-Schicht von SQLite hat eine Zeitüberschreitung erlitten. Das gibt nur Builds zurück, die mit SQLITE_ENABLE_SETLK_TIMEOUT kompiliert wurden.

Ergebniscode
SQLITE_BUSY_TIMEOUT
Name
773
Kategorie
Erweiterte Ergebnis-Codes
Fehlermeldung
database is locked

Was es bedeutet

Die SQLite-Dokumentation beschreibt SQLITE_BUSY_TIMEOUT (773) als eine blockierende POSIX-Advisory-Dateisperranfrage, die wegen einer Zeitüberschreitung fehlgeschlagen ist. Blockierende Sperren werden nur verwendet, wenn SQLite mit SQLITE_ENABLE_SETLK_TIMEOUTkompiliert ist, sodass die meisten Anwendungen diesen Code nie sehen; sie erhalten einfach SQLITE_BUSY wenn eine Sperre nicht abgerufen werden kann.

Häufige Ursachen

  • Eine andere Verbindung hielt die Sperre länger als die konfigurierte Wartezeit, auf einem Build, der blockierende Sperren verwendet.

Wie du es behebst

  1. Behandle es wie SQLITE_BUSY: halte Schreibtransaktionen kurz, verwende den WAL-Modus und versuche es erneut.

  2. Erhöhe die Wartezeit, wenn der Sperrinhaber vermutlich länger braucht.

    PRAGMA busy_timeout = 10000;

Zugehörige Fehler

Weitere Fehler bei erweiterten Ergebniscodes

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.

// weniger Fehler, schnellere Korrekturen

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.