// Fehlerreferenz

SQLite-Fehlercodes

Alle SQLite-Ergebniscodes aus der offiziellen Liste, primär und erweitert, mit dem Text sqlite3_errstr() liefert für jeden Primärcode. Die, denen du wahrscheinlich begegnest, haben eine eigene Seite mit Ursachen und Lösungen.

Eine SQLite-Fehlermeldung lesen

SQLite-Funktionen geben einen ganzzahligen Ergebniscode zurück. Die unteren acht Bits sind der primäre Code, wie zum Beispiel SQLITE_BUSY (5). Erweiterte Codes fügen in den höheren Bits Details hinzu: SQLITE_BUSY_SNAPSHOT ist 517, was 5 + 2 × 256 ist. Erweiterte Codes werden zurückgegeben, wenn sie aktiviert sind mit sqlite3_extended_result_codes() oder lesen mit sqlite3_extended_errcode().

Die Meldung, die ein Programm anzeigt, stammt meist von sqlite3_errmsg(), das spezifischer sein kann als der allgemeine Text, zum Beispiel UNIQUE constraint failed: users.email statt constraint failed.

Sprachbindungen kapseln diese Codes: Pythons sqlite3 Modul wirft OperationalError oder IntegrityError und, seit Python 3.11, wird sqlite_errorcode und sqlite_errorname bei der Ausnahme angezeigt.

Alle SQLite-Fehler in diesem Nachschlagewerk

105 Codes, 40 mit einer vollständigen Beschreibung (verlinkt). Codes und Meldungen stammen aus der SQLite-Dokumentation zu Ergebnis- und Fehlercodes.

Primäre Ergebniscodes

CodeBedeutung
SQLITE_OK 0 kein Fehler
SQLITE_ERROR SQL-Logikfehler 1 SQL-Logikfehler
SQLITE_INTERNAL 2
SQLITE_PERM Zugriffsberechtigung verweigert 3 Zugriffsberechtigung verweigert
SQLITE_ABORT Abfrage abgebrochen 4 Abfrage abgebrochen
SQLITE_BUSY Datenbank ist gesperrt 5 Datenbank ist gesperrt
SQLITE_LOCKED Datenbanktabelle ist gesperrt 6 Datenbanktabelle ist gesperrt
SQLITE_NOMEM kein Speicher mehr 7 kein Speicher mehr
SQLITE_READONLY Versuch, in eine schreibgeschützte Datenbank zu schreiben 8 Versuch, in eine schreibgeschützte Datenbank zu schreiben
SQLITE_INTERRUPT unterbrochen 9 unterbrochen
SQLITE_IOERR Festplatten-I/O-Fehler 10 Festplatten-I/O-Fehler
SQLITE_CORRUPT Datenbank-Disk-Image ist beschädigt 11 Datenbank-Disk-Image ist beschädigt
SQLITE_NOTFOUND 12 unbekannte Operation
SQLITE_FULL Datenbank oder Festplatte ist voll 13 Datenbank oder Festplatte ist voll
SQLITE_CANTOPEN Datenbankdatei kann nicht geöffnet werden 14 Datenbankdatei kann nicht geöffnet werden
SQLITE_PROTOCOL Sperrprotokoll 15 Sperrprotokoll
SQLITE_EMPTY 16
SQLITE_SCHEMA Datenbankschema wurde geändert 17 Datenbankschema wurde geändert
SQLITE_TOOBIG Zeichenkette oder Blob zu groß 18 Zeichenkette oder Blob zu groß
SQLITE_CONSTRAINT Constraint fehlgeschlagen 19 Constraint fehlgeschlagen
SQLITE_MISMATCH Datentyp stimmt nicht überein 20 Datentyp stimmt nicht überein
SQLITE_MISUSE ungültiger Parameter oder andere falsche API-Verwendung 21 ungültiger Parameter oder andere falsche API-Verwendung
SQLITE_NOLFS 22
SQLITE_AUTH Autorisierung verweigert 23 Autorisierung verweigert
SQLITE_FORMAT 24
SQLITE_RANGE Spaltenindex außerhalb des Bereichs 25 Spaltenindex außerhalb des Bereichs
SQLITE_NOTADB Datei ist keine Datenbank 26 Datei ist keine Datenbank
SQLITE_NOTICE 27 Benachrichtigung
SQLITE_WARNING 28 Warnmeldung
SQLITE_ROW 100 eine weitere Zeile verfügbar
SQLITE_DONE 101 keine weiteren Zeilen verfügbar

Erweiterte Ergebnis-Codes

CodeBedeutung
SQLITE_OK_LOAD_PERMANENTLY 256
SQLITE_ERROR_MISSING_COLLSEQ keine solche Sortierreihenfolge 257 keine solche Sortierreihenfolge: unicode_ci
SQLITE_BUSY_RECOVERY ein anderer Prozess stellt das WAL wieder her 261 Datenbank ist gesperrt
SQLITE_LOCKED_SHAREDCACHE Datensatz im gemeinsamen Cache gesperrt 262 Datenbanktabelle ist gesperrt
SQLITE_READONLY_RECOVERY 264
SQLITE_IOERR_READ 266
SQLITE_CORRUPT_VTAB 267
SQLITE_CANTOPEN_NOTEMPDIR 270
SQLITE_CONSTRAINT_CHECK CHECK-Constraint fehlgeschlagen 275 CHECK-Constraint fehlgeschlagen: price_positive
SQLITE_AUTH_USER 279
SQLITE_NOTICE_RECOVER_WAL 283
SQLITE_WARNING_AUTOINDEX 284
SQLITE_ERROR_RETRY 513
SQLITE_ABORT_ROLLBACK Anweisung durch ROLLBACK abgebrochen 516 Abbruch aufgrund von ROLLBACK
SQLITE_BUSY_SNAPSHOT ein veralteter Lesevorgang kann nicht zu einem Schreibvorgang werden 517 Datenbank ist gesperrt
SQLITE_LOCKED_VTAB 518
SQLITE_READONLY_CANTLOCK 520
SQLITE_IOERR_SHORT_READ Lesevorgang lieferte weniger Bytes zurück 522 Festplatten-I/O-Fehler
SQLITE_CORRUPT_SEQUENCE 523
SQLITE_CANTOPEN_ISDIR der Pfad ist ein Verzeichnis 526 Datenbankdatei kann nicht geöffnet werden
SQLITE_CONSTRAINT_COMMITHOOK 531
SQLITE_NOTICE_RECOVER_ROLLBACK 539
SQLITE_ERROR_SNAPSHOT 769
SQLITE_BUSY_TIMEOUT Zeitüberschreitung bei blockierender Dateisperre 773 Datenbank ist gesperrt
SQLITE_READONLY_ROLLBACK heißes Journal kann nicht zurückgerollt werden 776 Versuch, in eine schreibgeschützte Datenbank zu schreiben
SQLITE_IOERR_WRITE 778
SQLITE_CORRUPT_INDEX Indexeintrag fehlt 779 Datenbank-Disk-Image ist beschädigt
SQLITE_CANTOPEN_FULLPATH 782
SQLITE_CONSTRAINT_FOREIGNKEY Fremdschlüssel-Constraint fehlgeschlagen 787 Fremdschlüssel-Constraint fehlgeschlagen
SQLITE_READONLY_DBMOVED Datenbankdatei wurde im geöffneten Zustand verschoben 1032 Versuch, in eine schreibgeschützte Datenbank zu schreiben
SQLITE_IOERR_FSYNC 1034
SQLITE_CANTOPEN_CONVPATH 1038
SQLITE_CONSTRAINT_FUNCTION 1043
SQLITE_READONLY_CANTINIT 1288
SQLITE_IOERR_DIR_FSYNC 1290
SQLITE_CANTOPEN_DIRTYWAL 1294
SQLITE_CONSTRAINT_NOTNULL NOT NULL-Constraint fehlgeschlagen 1299 NOT NULL-Constraint fehlgeschlagen: users.name
SQLITE_READONLY_DIRECTORY Kann die Journaldatei nicht erstellen 1544 Versuch, in eine schreibgeschützte Datenbank zu schreiben
SQLITE_IOERR_TRUNCATE 1546
SQLITE_CONSTRAINT_PRIMARYKEY PRIMARY KEY-Constraint fehlgeschlagen 1555 UNIQUE-Einschränkung fehlgeschlagen: orders.id
SQLITE_IOERR_FSTAT 1802
SQLITE_CONSTRAINT_TRIGGER RAISE() in einem Trigger hat die Anweisung abgebrochen 1811 Constraint fehlgeschlagen
SQLITE_IOERR_UNLOCK 2058
SQLITE_CONSTRAINT_UNIQUE UNIQUE-Einschränkung fehlgeschlagen 2067 UNIQUE-Einschränkung fehlgeschlagen: users.email
SQLITE_IOERR_RDLOCK 2314
SQLITE_CONSTRAINT_VTAB 2323
SQLITE_IOERR_DELETE 2570
SQLITE_CONSTRAINT_ROWID 2579
SQLITE_IOERR_BLOCKED 2826
SQLITE_CONSTRAINT_PINNED 2835
SQLITE_IOERR_NOMEM 3082
SQLITE_CONSTRAINT_DATATYPE Wert passt nicht in eine STRICT-Spalte 3091 Kann keinen TEXT-Wert in INTEGER-Spalte t.qty speichern
SQLITE_IOERR_ACCESS 3338
SQLITE_IOERR_CHECKRESERVEDLOCK 3594
SQLITE_IOERR_LOCK 3850
SQLITE_IOERR_CLOSE 4106
SQLITE_IOERR_DIR_CLOSE 4362
SQLITE_IOERR_SHMOPEN 4618
SQLITE_IOERR_SHMSIZE 4874
SQLITE_IOERR_SHMLOCK 5130
SQLITE_IOERR_SHMMAP 5386
SQLITE_IOERR_SEEK 5642
SQLITE_IOERR_DELETE_NOENT 5898
SQLITE_IOERR_MMAP 6154
SQLITE_IOERR_GETTEMPPATH 6410
SQLITE_IOERR_CONVPATH 6666
SQLITE_IOERR_VNODE 6922
SQLITE_IOERR_AUTH 7178
SQLITE_IOERR_BEGIN_ATOMIC 7434
SQLITE_IOERR_COMMIT_ATOMIC 7690
SQLITE_IOERR_ROLLBACK_ATOMIC 7946
SQLITE_IOERR_DATA 8202
SQLITE_IOERR_CORRUPTFS 8458
// ein Client für jede Engine

Ein schnellerer Weg, mit SQLite zu arbeiten

SQLLY ist ein nativer SQL-Client für macOS, Windows und Linux mit schemabewusstem IntelliSense und Leitplanken für riskante Anweisungen.