SQLite: Fehlercodes

Der Ergebniscode SQLITE_INTERRUPT gibt an, dass ein Vorgang durch die Schnittstelle sqlite3_interrupt() unterbrochen wurde. Siehe auch: SQLITE_ABORT

Der Ergebniscode SQLITE_IOERR besagt, dass der Vorgang nicht abgeschlossen werden konnte, da das Betriebssystem einen E/A-Fehler gemeldet hat. Ein volles Festplattenlaufwerk führt normalerweise zu einem SQLITE_FULL-Fehler und nicht zu einem SQLITE_IOERR-Fehler. Es gibt viele verschiedene erweiterte Ergebniscodes für E/A-Fehler, die den spezifischen E/A-Vorgang identifizieren, der fehlgeschlagen ist.

Der SQLITE_IOERR_ACCESS-Fehlercode ist ein erweiterter Fehlercode für SQLITE_IOERR, der auf einen E/A-Fehler innerhalb der xAccess-Methode für das sqlite3_vfs-Objekt hinweist.

Der Fehlercode SQLITE_IOERR_AUTH ist ein Code, der für die Verwendung durch Erweiterungen reserviert ist. Es wird vom SQLite-Kern nicht verwendet.

Der Fehlercode SQLITE_IOERR_BEGIN_ATOMIC weist darauf hin, dass das zugrunde liegende Betriebssystem einen Fehler in der Dateisteuerung SQLITE_FCNTL_BEGIN_ATOMIC_WRITE gemeldet hat. Dies tritt nur auf, wenn SQLITE_ENABLE_ATOMIC_WRITE aktiviert ist und die Datenbank auf einem Dateisystem gehostet wird, das atomare Schreibvorgänge unterstützt.

Der Fehlercode SQLITE_IOERR_BLOCKED wird nicht mehr verwendet.

Der SQLITE_IOERR_CHECKRESERVEDLOCK-Fehlercode ist ein erweiterter Fehlercode für SQLITE_IOERR, der auf einen E/A-Fehler innerhalb der xCheckReservedLock-Methode für das sqlite3_io_methods-Objekt hinweist.

Der Fehlercode SQLITE_IOERR_CLOSE ist ein erweiterter Fehlercode für SQLITE_IOERR, der auf einen E/A-Fehler innerhalb der xClose-Methode des sqlite3_io_methods-Objekts hinweist.

Der Fehlercode SQLITE_IOERR_COMMIT_ATOMIC weist darauf hin, dass das zugrunde liegende Betriebssystem einen Fehler in der Dateisteuerung SQLITE_FCNTL_COMMIT_ATOMIC_WRITE gemeldet hat. Dies tritt nur auf, wenn SQLITE_ENABLE_ATOMIC_WRITE aktiviert ist und die Datenbank auf einem Dateisystem gehostet wird, das atomare Schreibvorgänge unterstützt.

Der Fehlercode SQLITE_IOERR_CONVPATH ist ein erweiterter Fehlercode für SQLITE_IOERR, der nur von Cygwin VFS verwendet wird und darauf hinweist, dass der Systemaufruf cygwin_conv_path() fehlgeschlagen ist. Siehe auch: SQLITE_CANTOPEN_CONVPATH

Der SQLITE_IOERR_CORRUPTFS-Fehlercode ist ein erweiterter Fehlercode für SQLITE_IOERR, der nur von einem VFS verwendet wird, um anzuzeigen, dass ein Such- oder Lesefehler darauf zurückzuführen ist, dass die Anforderung nicht innerhalb der Dateigrenze liegt, und nicht auf einen gewöhnlichen Gerätefehler. Dies weist häufig auf ein beschädigtes Dateisystem hin. Diese Seite wurde zuletzt am 18.02.2026 um 11:56:50 Uhr aktualisiert

Der SQLITE_IOERR_DATA-Fehlercode ist ein erweiterter Fehlercode für SQLITE_IOERR, der nur vom Prüfsummen-VFS-Shim verwendet wird, um anzuzeigen, dass die Prüfsumme auf einer Seite der Datenbankdatei falsch ist.

Der SQLITE_IOERR_DELETE-Fehlercode ist ein erweiterter Fehlercode für SQLITE_IOERR, der auf einen E/A-Fehler innerhalb der xDelete-Methode für das sqlite3_vfs-Objekt hinweist.

Der Fehlercode SQLITE_IOERR_DELETE_NOENT ist ein erweiterter Fehlercode für SQLITE_IOERR, der angibt, dass die xDelete-Methode für das sqlite3_vfs-Objekt fehlgeschlagen ist, weil die zu löschende Datei nicht vorhanden ist.

Der Fehlercode SQLITE_IOERR_DIR_CLOSE wird nicht mehr verwendet.

Der SQLITE_IOERR_DIR_FSYNC-Fehlercode ist ein erweiterter Fehlercode für SQLITE_IOERR, der auf einen E/A-Fehler in der VFS-Ebene beim Versuch, fsync() für ein Verzeichnis aufzurufen, hinweist. Das Unix-VFS versucht, Verzeichnisse nach dem Erstellen oder Löschen bestimmter Dateien mit fsync() zu synchronisieren, um sicherzustellen, dass diese Dateien nach einem Stromausfall oder Systemabsturz weiterhin im Dateisystem angezeigt werden. Dieser Fehlercode weist auf ein Problem beim Versuch, fsync() auszuführen, hin.

Der SQLITE_IOERR_FSTAT-Fehlercode ist ein erweiterter Fehlercode für SQLITE_IOERR, der auf einen E/A-Fehler in der VFS-Ebene beim Versuch hinweist, fstat() (oder das Äquivalent) für eine Datei aufzurufen, um Informationen wie die Dateigröße oder Zugriffsberechtigungen zu ermitteln.

Der SQLITE_IOERR_FSYNC-Fehlercode ist ein erweiterter Fehlercode für SQLITE_IOERR, der auf einen E/A-Fehler in der VFS-Ebene beim Versuch hinweist, zuvor geschriebene Inhalte aus Betriebssystem- und/oder Festplattensteuerungspuffern in den dauerhaften Speicher zu leeren. Mit anderen Worten: Dieser Code weist auf ein Problem mit dem Systemaufruf fsync() unter Unix oder dem Systemaufruf FlushFileBuffers() unter Windows hin.

Der Fehlercode SQLITE_IOERR_GETTEMPPATH ist ein erweiterter Fehlercode für SQLITE_IOERR, der darauf hinweist, dass das VFS kein geeignetes Verzeichnis zum Ablegen temporärer Dateien ermitteln kann.

Der Fehlercode SQLITE_IOERR_LOCK ist ein erweiterter Fehlercode für SQLITE_IOERR, der auf einen E/A-Fehler in der Sperrlogik der Empfehlungsdatei hinweist. Normalerweise weist ein SQLITE_IOERR_LOCK-Fehler auf ein Problem beim Erhalten einer PENDING-Sperre hin. Es kann jedoch auch auf verschiedene Sperrfehler bei einigen der auf Macs verwendeten speziellen VFSes hinweisen.

Der SQLITE_IOERR_MMAP-Fehlercode ist ein erweiterter Fehlercode für SQLITE_IOERR, der auf einen E/A-Fehler innerhalb der xFetch- oder xUnfetch-Methoden für das sqlite3_io_methods-Objekt hinweist, während versucht wird, einen Teil der Datenbankdatei dem Prozessadressraum zuzuordnen oder die Zuordnung aufzuheben.

Der Fehlercode SQLITE_IOERR_NOMEM wird manchmal von der VFS-Schicht zurückgegeben, um anzuzeigen, dass ein Vorgang nicht abgeschlossen werden konnte, weil nicht genügend Speicher zugewiesen werden konnte. Dieser Fehlercode wird normalerweise von den höheren Schichten von SQLite in SQLITE_NOMEM umgewandelt, bevor er an die Anwendung zurückgegeben wird.

Der SQLITE_IOERR_RDLOCK-Fehlercode ist ein erweiterter Fehlercode für SQLITE_IOERR, der auf einen E/A-Fehler innerhalb der xLock-Methode für das sqlite3_io_methods-Objekt beim Versuch, eine Lesesperre zu erhalten, hinweist.

Der SQLITE_IOERR_READ-Fehlercode ist ein erweiterter Fehlercode für SQLITE_IOERR, der auf einen E/A-Fehler in der VFS-Ebene beim Versuch, aus einer Datei auf der Festplatte zu lesen, hinweist. Dieser Fehler kann auf eine Hardwarefehlfunktion oder darauf zurückzuführen sein, dass ein Dateisystem beim Öffnen der Datei nicht mehr bereitgestellt wurde.

Der Fehlercode SQLITE_IOERR_ROLLBACK_ATOMIC weist darauf hin, dass das zugrunde liegende Betriebssystem einen Fehler in der Dateisteuerung SQLITE_FCNTL_ROLLBACK_ATOMIC_WRITE gemeldet hat. Dies tritt nur auf, wenn SQLITE_ENABLE_ATOMIC_WRITE aktiviert ist und die Datenbank auf einem Dateisystem gehostet wird, das atomare Schreibvorgänge unterstützt.

Der SQLITE_IOERR_SEEK-Fehlercode ist ein erweiterter Fehlercode für SQLITE_IOERR, der auf einen E/A-Fehler innerhalb der xRead- oder xWrite-Methoden im sqlite3_io_methods-Objekt hinweist, während versucht wird, einen Dateideskriptor für den Anfangspunkt der Datei zu suchen, an dem der Lese- oder Schreibvorgang erfolgen soll.

Der Fehlercode SQLITE_IOERR_SHMLOCK wird nicht mehr verwendet.

Der SQLITE_IOERR_SHMMAP-Fehlercode ist ein erweiterter Fehlercode für SQLITE_IOERR, der auf einen E/A-Fehler innerhalb der xShmMap-Methode für das sqlite3_io_methods-Objekt beim Versuch hinweist, ein gemeinsam genutztes Speichersegment dem Prozessadressraum zuzuordnen.

Der Fehlercode SQLITE_IOERR_SHMOPEN ist ein erweiterter Fehlercode für SQLITE_IOERR, der auf einen E/A-Fehler innerhalb der xShmMap-Methode im sqlite3_io_methods-Objekt beim Versuch, ein neues gemeinsam genutztes Speichersegment zu öffnen, hinweist.

Der SQLITE_IOERR_SHMSIZE-Fehlercode ist ein erweiterter Fehlercode für SQLITE_IOERR, der auf einen E/A-Fehler innerhalb der xShmMap-Methode für das sqlite3_io_methods-Objekt beim Versuch hinweist, eine „shm“-Datei im Rahmen der Transaktionsverarbeitung im WAL-Modus zu vergrößern. Dieser Fehler weist möglicherweise darauf hin, dass auf dem zugrunde liegenden Dateisystem-Volume nicht mehr genügend Speicherplatz vorhanden ist.

Der Fehlercode SQLITE_IOERR_SHORT_READ ist ein erweiterter Fehlercode für SQLITE_IOERR, der darauf hinweist, dass ein Leseversuch in der VFS-Schicht nicht so viele Bytes abrufen konnte, wie angefordert wurden. Dies kann an einer abgeschnittenen Datei liegen.

Der SQLITE_IOERR_TRUNCATE-Fehlercode ist ein erweiterter Fehlercode für SQLITE_IOERR, der auf einen E/A-Fehler in der VFS-Ebene beim Versuch hinweist, die Größe einer Datei mithilfe der xTruncate-Methode des sqlite3_io_methods-Objekts zu ändern.

Der SQLITE_IOERR_UNLOCK-Fehlercode ist ein erweiterter Fehlercode für SQLITE_IOERR, der auf einen E/A-Fehler innerhalb der xUnlock-Methode für das sqlite3_io_methods-Objekt hinweist.

Der Fehlercode SQLITE_IOERR_VNODE ist ein Code, der für die Verwendung durch Erweiterungen reserviert ist. Es wird vom SQLite-Kern nicht verwendet.

Der SQLITE_IOERR_WRITE-Fehlercode ist ein erweiterter Fehlercode für SQLITE_IOERR, der auf einen E/A-Fehler in der VFS-Ebene beim Versuch, in eine Datei auf der Festplatte zu schreiben, hinweist. Dieser Fehler kann auf eine Hardwarefehlfunktion oder darauf zurückzuführen sein, dass ein Dateisystem beim Öffnen der Datei nicht mehr bereitgestellt wurde. Dieser Fehler sollte nicht auftreten, wenn das Dateisystem voll ist, da es für diesen Zweck einen separaten Fehlercode (SQLITE_FULL) gibt.

Der Ergebniscode SQLITE_LOCKED gibt an, dass ein Schreibvorgang aufgrund eines Konflikts innerhalb derselben Datenbankverbindung oder eines Konflikts mit einer anderen Datenbankverbindung, die einen gemeinsam genutzten Cache verwendet, nicht fortgesetzt werden konnte. Beispielsweise kann eine DROP TABLE-Anweisung nicht ausgeführt werden, während ein anderer Thread über dieselbe Datenbankverbindung aus dieser Tabelle liest, da das Löschen der Tabelle die Tabelle aus dem gleichzeitigen Lesegerät löschen würde. Der Ergebniscode SQLITE_LOCKED unterscheidet sich von SQLITE_BUSY darin, dass SQLITE_LOCKED auf einen Konflikt bei derselben Datenbankverbindung (oder bei einer Verbindung mit einem gemeinsam genutzten Cache) hinweist, während SQLITE_BUSY auf einen Konflikt mit einer anderen Datenbankverbindung hinweist, wahrscheinlich in einem anderen Prozess.

Der Ergebniscode SQLITE_LOCKED_SHAREDCACHE gibt an, dass der Zugriff auf einen SQLite-Datensatz durch eine andere Datenbankverbindung blockiert wird, die denselben Datensatz im Shared-Cache-Modus verwendet. Wenn sich zwei oder mehr Datenbankverbindungen denselben Cache teilen und eine der Verbindungen gerade einen Datensatz in diesem Cache ändert, wird der Zugriff anderer Verbindungen auf diese Daten während der laufenden Änderungen blockiert, um zu verhindern, dass die Leser eine beschädigte oder teilweise abgeschlossene Änderung sehen.

Der SQLITE_LOCKED_VTAB-Ergebniscode wird nicht vom SQLite-Kern verwendet, steht aber für die Verwendung durch Erweiterungen zur Verfügung. Implementierungen virtueller Tabellen können diesen Ergebniscode zurückgeben, um anzuzeigen, dass sie den aktuellen Vorgang aufgrund von Sperren anderer Threads oder Prozesse nicht abschließen können. Die R-Tree-Erweiterung gibt diesen Ergebniscode zurück, wenn versucht wird, den R-Tree zu aktualisieren, während eine andere vorbereitete Anweisung den R-Tree aktiv liest. Die Aktualisierung kann nicht fortgesetzt werden, da jede Änderung an einem R-Baum möglicherweise eine Neuordnung und Neuverteilung von Knoten mit sich bringt, was zu Störungen der Lesecursor führen würde und dazu führen würde, dass einige Zeilen wiederholt und andere Zeilen weggelassen werden.

Der Fehlercode SQLITE_MISMATCH weist auf eine Nichtübereinstimmung des Datentyps hin. SQLite ist normalerweise sehr tolerant gegenüber Diskrepanzen zwischen dem Typ eines Werts und dem deklarierten Typ des Containers, in dem dieser Wert gespeichert werden soll. Beispielsweise ermöglicht SQLite der Anwendung, ein großes BLOB in einer Spalte mit dem deklarierten Typ BOOLEAN zu speichern. In einigen Fällen ist SQLite jedoch hinsichtlich der Typen streng. Der SQLITE_MISMATCH-Fehler wird in den wenigen Fällen zurückgegeben, in denen die Typen nicht übereinstimmen. Die Zeilen-ID einer Tabelle muss eine Ganzzahl sein. Der Versuch, die Zeilen-ID auf etwas anderes als eine Ganzzahl (oder einen NULL-Wert, der automatisch in die nächste verfügbare Ganzzahl-Zeilen-ID konvertiert wird) festzulegen, führt zu einem SQLITE_MISMATCH-Fehler.

Der SQLITE_MISUSE-Rückgabecode wird möglicherweise zurückgegeben, wenn die Anwendung eine SQLite-Schnittstelle auf eine nicht definierte oder nicht unterstützte Weise verwendet. Wenn Sie beispielsweise eine vorbereitete Anweisung verwenden, nachdem diese vorbereitete Anweisung fertiggestellt wurde, kann dies zu einem SQLITE_MISUSE-Fehler führen. Mithilfe dieses Ergebniscodes versucht SQLite, Missbrauch zu erkennen und den Missbrauch zu melden. Es gibt jedoch keine Garantie dafür, dass die Missbrauchserkennung erfolgreich ist. Die Erkennung von Missbrauch erfolgt probabilistisch. Anwendungen sollten niemals von einem SQLITE_MISUSE-Rückgabewert abhängen. Wenn SQLite jemals SQLITE_MISUSE von einer Schnittstelle zurückgibt, bedeutet das, dass die Anwendung falsch codiert ist und repariert werden muss. Versenden Sie keine Anwendung, die manchmal SQLITE_MISUSE von einer Standard-SQLite-Schnittstelle zurückgibt, da diese Anwendung potenziell schwerwiegende Fehler enthält.