// SQLite-Fehlerreferenz

SQLITE_IOERR: Festplatten-I/O-Fehler

Das Betriebssystem meldete einen E/A-Fehler, während SQLite eine Datei las, schrieb, synchronisierte oder sperrte. Der erweiterte Code sagt, welche Operation fehlgeschlagen ist.

Ergebniscode
SQLITE_IOERR
Name
10
Kategorie
Primäre Ergebniscodes
Fehlermeldung
disk I/O error

Was es bedeutet

SQLITE_IOERR (10) bedeutet, dass eine Dateioperation auf Betriebssystemebene fehlgeschlagen ist. SQLite hat viele erweiterte Codes dafür, wie zum Beispiel SQLITE_IOERR_READ, SQLITE_IOERR_WRITE, SQLITE_IOERR_FSYNC, SQLITE_IOERR_SHORT_READ (weniger Bytes als angefordert, zum Beispiel eine abgeschnittene Datei) und SQLITE_IOERR_LOCK. Eine volle Festplatte gibt normalerweise SQLITE_FULL stattdessen.

Der erweiterte Code ist der beste Hinweis — schalte also erweiterte Ergebniscodes ein oder lies sie mit sqlite3_extended_errcode().

Häufige Ursachen

  • Ausfallender oder getrennter Speicher: ein entfernter USB-Stick, ein nicht eingebundenes Netzlaufwerk, eine defekte Festplatte.
  • Ein Netzwerk-Dateisystem oder Synchronisierungsordner, der das Sperren oder Synchronisieren, das SQLite benötigt, nicht unterstützt.
  • Antiviren- oder Backup-Software, die die Datei hält oder ändert.
  • Die Datei wurde gekürzt oder unter einer offenen Verbindung ausgetauscht.

Wie du es behebst

  1. Lies den erweiterten Code, um zu sehen, welche Operation fehlgeschlagen ist, und prüfe die Betriebssystemprotokolle auf Festplattenfehler.

  2. Halte die Datenbank auf einer lokalen Festplatte. Wenn sie geteilt werden muss, teile nicht die Datei: Stelle einen Server davor.

  3. Schließe die Datenbank aus, -journal, -wal und -shm Dateien vom Antivirus-Scan und von Datei-Synchronisations-Tools aus.

  4. Prüfe nach einem I/O-Fehler die Datei, bevor du ihr vertraust.

    PRAGMA integrity_check;

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.