// SQLite-Fehlerreferenz

SQLITE_READONLY: Versuch, in eine schreibgeschützte Datenbank zu schreiben

Die Verbindung kann nicht schreiben: Die Datei oder ihr Verzeichnis ist nicht beschreibbar, die Datenbank wurde im Nur-Lese-Modus geöffnet oder SQLite kann seine Journaldatei nicht erstellen.

Ergebniscode
SQLITE_READONLY
Name
8
Kategorie
Primäre Ergebniscodes
Fehlermeldung
attempt to write a readonly database

Was es bedeutet

SQLITE_READONLY (8) wird zurückgegeben, wenn eine Anweisung versucht, Daten zu ändern, für die die Verbindung keine Schreibberechtigung hat. Zum Schreiben werden Berechtigungen für die Datenbankdatei und auch für ihr Verzeichnis benötigt, da SQLite eine Journaldatei (-journal) oder WAL (-wal, -shm) Datei daneben erstellt.

Erweiterte Codes sagen dir, warum: SQLITE_READONLY_DIRECTORY (keine Berechtigung zum Erstellen der Journaldatei), SQLITE_READONLY_DBMOVED (die Datei wurde verschoben oder gelöscht, während sie geöffnet war), SQLITE_READONLY_ROLLBACK (ein Hot-Journal muss zurückgesetzt werden, aber die Datenbank ist schreibgeschützt), und andere.

Häufige Ursachen

  • Die Datenbankdatei gehört einem anderen Benutzer oder ist schreibgeschützt eingehängt, typisch für einen Webserver-Benutzer oder eine Datei innerhalb eines App-Bundles.
  • Das Verzeichnis ist nicht beschreibbar, daher kann SQLite die Journaldatei nicht anlegen, obwohl die Datei selbst beschreibbar ist.
  • Die Verbindung wurde nur lesend geöffnet (SQLITE_OPEN_READONLY, ?mode=ro URI, oder PRAGMA query_only = ON).
  • Die Datei wurde verschoben, umbenannt oder gelöscht, während die Verbindung geöffnet war (SQLITE_READONLY_DBMOVED).

Wie du es behebst

  1. Gib dem Prozess Schreibrechte für die Datei und ihr Verzeichnis. Prüfe auf Linux und macOS mit ls -l auf beiden, dann korrigiere Eigentümer oder Modus.

  2. Prüfe, ob die Verbindung selbst schreibgeschützt ist.

    PRAGMA query_only;
    PRAGMA database_list;
  3. Öffne die Datenbank mit Schreibzugriff: drop mode=ro vom URI oder dem Schreibschutz-Flag aus dem Open-Aufruf.

  4. Wurde die Datei verschoben, während sie offen war, schließ die Verbindung und öffne sie wieder unter ihrem neuen Pfad.

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.