// SQLite-Fehlerreferenz

SQLITE_PROTOCOL: Sperrprotokoll

Im WAL-Modus hat eine Verbindung mehrere Sekunden lang immer wieder das Rennen zum Starten einer Transaktion verloren und aufgegeben. Sehr selten; ein Zeichen für starke Schreibkonkurrenz.

Ergebniscode
SQLITE_PROTOCOL
Name
15
Kategorie
Primäre Ergebniscodes
Fehlermeldung
locking protocol

Was es bedeutet

Die SQLite-Dokumentation beschreibt SQLITE_PROTOCOL (15) als ein Problem mit dem Dateisperrprotokoll, das derzeit nur im WAL-Modus beim Starten einer Transaktion zurückgegeben wird. Wenn zwei Verbindungen darum konkurrieren, eine Transaktion zu starten, zieht sich der Verlierer zurück und versucht es erneut; wenn dieselbe Verbindung über mehrere Sekunden hinweg verliert, wird zurückgegeben SQLITE_PROTOCOL. Es sollte nur auftreten, wenn viele Prozesse stark darum konkurrieren, dieselbe Datenbank zu schreiben.

Häufige Ursachen

  • Viele Prozesse schreiben gleichzeitig dieselbe WAL-Modus-Datenbank.
  • Dateisperre, die sich falsch verhält, zum Beispiel auf einem Netzwerk-Dateisystem.

Wie du es behebst

  1. Reduziere die Zahl gleichzeitiger Schreiber, zum Beispiel indem du Schreibvorgänge über einen Prozess oder eine Warteschlange bündelst.

  2. Halte die Datenbank auf einer lokalen Festplatte mit funktionierenden Sperren.

  3. Behandle es wie SQLITE_BUSY: wiederhole die Transaktion nach einer kurzen Pause.

Zugehörige Fehler

Weitere Fehler bei primären 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.