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
| Code | Bedeutung |
|---|---|
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
| Code | Bedeutung |
|---|---|
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_CANTOPEN_SYMLINK
|
1550
|
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
|
Andere Datenbanken
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.