// SQLite-Fehlerreferenz

SQLITE_BUSY_SNAPSHOT: Veralteter Lesezustand kann nicht in einen Schreibvorgang übergehen

Im WAL-Modus wollte eine Transaktion, die mit Lesen begonnen hatte, schreiben, nachdem eine andere Verbindung die Datenbank schon geändert hatte. Warten hilft nichts; starte die Transaktion neu.

Ergebniscode
SQLITE_BUSY_SNAPSHOT
Name
517
Kategorie
Erweiterte Ergebnis-Codes
Fehlermeldung
database is locked

Was es bedeutet

SQLITE_BUSY_SNAPSHOT (517) tritt nur bei WAL-Mode-Datenbanken auf. Eine Lese-Transaktion sieht einen Snapshot der Datenbank. Wenn sie dann versucht zu schreiben, muss SQLite sie auf eine Schreib-Transaktion hochstufen, aber wenn eine andere Verbindung Änderungen nach der Aufnahme des Snapshots festgeschrieben hat, sind die vorherigen Lesevorgänge nicht mehr aktuell und die Hochstufung wird verweigert.

Im Gegensatz zu normalem SQLITE_BUSYbehebt ein Busy-Timeout das nicht: Die Transaktion muss zurückgerollt und von vorn neu ausgeführt werden.

Häufige Ursachen

  • BEGIN (deferred), gefolgt von SELECT und dann UPDATE, während ein anderer Prozess zwischendurch commitet.
  • Lange Lese-Transaktionen in einer Anwendung, die später schreibend zugreifen will.

Wie du es behebst

  1. Starte Transaktionen, die schreiben sollen, mit BEGIN IMMEDIATE, daher wird das Schreib-Lock vor allen Lesevorgängen gesetzt.

    BEGIN IMMEDIATE;
    SELECT balance FROM accounts WHERE id = 1;
    UPDATE accounts SET balance = balance - 10 WHERE id = 1;
    COMMIT;
  2. Wenn das passiert, mache ein Rollback und wiederhole die gesamte Transaktion.

    ROLLBACK;

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.