// SQLite-Fehlerreferenz

SQLITE_CANTOPEN: Datenbankdatei kann nicht geöffnet werden

SQLite konnte die Datenbankdatei oder eine ihrer temporären Dateien nicht öffnen: ein falscher Pfad, ein fehlendes Verzeichnis, ein Berechtigungsproblem oder ein Pfad, der ein Verzeichnis ist.

Ergebniscode
SQLITE_CANTOPEN
Name
14
Kategorie
Primäre Ergebniscodes
Fehlermeldung
unable to open database file

Was es bedeutet

SQLITE_CANTOPEN (14) bedeutet, dass das Betriebssystem das Öffnen einer Datei, die SQLite benötigt, verweigert hat. Das ist normalerweise die Hauptdatenbankdatei, kann aber auch eine temporäre Datei sein. SQLite erstellt eine neue Datenbankdatei, wenn der Pfad nicht existiert, daher bedeutet dieser Fehler normalerweise, dass das Verzeichnis fehlt oder nicht beschreibbar ist, nicht, dass die Datei fehlt.

Erweiterte Codes grenzen dies ein, zum Beispiel SQLITE_CANTOPEN_ISDIR (der Pfad ist ein Verzeichnis) und SQLITE_CANTOPEN_FULLPATH (der vollständige Pfad konnte nicht aufgelöst werden).

Häufige Ursachen

  • Das Verzeichnis im Pfad existiert nicht; SQLite erstellt Dateien, keine Verzeichnisse.
  • Ein relativer Pfad, der gegen ein unerwartetes Arbeitsverzeichnis aufgelöst wird, zum Beispiel in einem Dienst oder einem Test-Runner.
  • Keine Berechtigung, die Datei zu lesen oder sie in diesem Verzeichnis zu erstellen.
  • Der Pfad zeigt auf ein Verzeichnis (SQLITE_CANTOPEN_ISDIR).
  • Das temporäre Verzeichnis fehlt oder ist nicht beschreibbar, daher kann keine temporäre Datei erstellt werden.
  • Zu viele offene Dateien im Prozess.

Wie du es behebst

  1. Verwende einen absoluten Pfad und stelle sicher, dass jedes Verzeichnis darin existiert.

  2. Prüfe die Berechtigungen der Datei und ihres Verzeichnisses für den Benutzer, unter dem das Programm läuft.

  3. Wenn temporäre Dateien das Problem sind, weise SQLite mit der auf ein beschreibbares Verzeichnis SQLITE_TMPDIR oder TMPDIR Umgebungsvariable, oder halte den temporären Speicher im Arbeitsspeicher.

    PRAGMA temp_store = MEMORY;
  4. Im sqlite3 Shell, prüfe, was geöffnet wurde.

    .databases

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.