SQLITE_CONSTRAINT_FOREIGNKEY: FOREIGN KEY-Einschränkung fehlgeschlagen
Ein Schreibvorgang würde eine untergeordnete Zeile auf einen nicht existierenden übergeordneten Eintrag verweisen lassen oder einen übergeordneten Eintrag löschen, der noch untergeordnete Einträge hat. Fremdschlüssel müssen pro Verbindung aktiviert werden.
- Ergebniscode
SQLITE_CONSTRAINT_FOREIGNKEY- Name
787- Kategorie
- Erweiterte Ergebnis-Codes
Was es bedeutet
SQLITE_CONSTRAINT_FOREIGNKEY (787) bedeutet, dass eine Fremdschlüsselprüfung fehlgeschlagen ist. SQLite erzwingt Fremdschlüssel nur bei Verbindungen, die PRAGMA foreign_keys = ON; standardmäßig ist es für Abwärtskompatibilität deaktiviert, weshalb derselbe Einfügevorgang in einem Tool erfolgreich sein kann und in einem anderen fehlschlägt.
Die Meldung sagt nicht, welcher Schlüssel fehlgeschlagen ist. PRAGMA foreign_key_check listet jede verletzende Zeile auf.
Häufige Ursachen
- Einfügen einer Kindzeile, deren Eltern-ID nicht existiert.
- Löschen oder Aktualisieren einer Elternzeile, die noch Kinder hat, ohne
ON DELETE CASCADEoderSET NULL. - Tabellen werden in der falschen Reihenfolge geladen: Kinder vor Eltern.
- Aufgeschobene Constraints (
DEFERRABLE INITIALLY DEFERRED) schlagen fehl beiCOMMIT.
Wie du es behebst
-
Finde die Zeilen, die einen Fremdschlüssel verletzen.
PRAGMA foreign_key_check; PRAGMA foreign_key_list(orders);
-
Füge übergeordnete Zeilen vor den untergeordneten ein oder lösche untergeordnete vor den übergeordneten.
-
Bei Massenladungen verlagerst du die Prüfung auf das Ende der Transaktion.
BEGIN; PRAGMA defer_foreign_keys = ON; -- load tables in any order COMMIT;
-
Soll das Löschen eines Elternteils auch seine Kinder entfernen, deklariere die Aktion am Fremdschlüssel.
CREATE TABLE orders ( id INTEGER PRIMARY KEY, customer_id INTEGER NOT NULL REFERENCES customers(id) ON DELETE CASCADE );
Sicher reproduzieren
PRAGMA foreign_keys = ON; CREATE TABLE p (id INTEGER PRIMARY KEY); CREATE TABLE c (pid INTEGER REFERENCES p(id)); INSERT INTO c VALUES (1); -- Runtime error: FOREIGN KEY constraint failed (19)
Fragen
Warum werden Fremdschlüssel in meiner SQLite-Datenbank nicht durchgesetzt?
Die Durchsetzung erfolgt pro Verbindung und ist standardmäßig aus. Jede Verbindung muss PRAGMA foreign_keys = ON setzen, und das lässt sich nicht innerhalb einer Transaktion ändern.
Zugehörige Fehler
SQLITE_CONSTRAINTConstraint fehlgeschlagen23503PostgreSQL: Fremdschlüsseleinschränkung verletzt1452MySQL: Fremdschlüssel schlägt fehl: kann untergeordnete Zeile nicht hinzufügen1451MySQL: Fremdschlüssel schlägt fehl: kann übergeordnete Zeile nicht löschen547SQL Server: Anweisung stand in Konflikt mit einer EinschränkungORA-02291Oracle: Integritäts-Constraint verletzt - kein übergeordneter SchlüsselORA-02292Oracle: Integritäts-Constraint verletzt - untergeordneter Datensatz gefunden
Weitere Fehler bei erweiterten Ergebniscodes
SQLITE_ERROR_MISSING_COLLSEQkeine solche SortierreihenfolgeSQLITE_BUSY_RECOVERYein anderer Prozess stellt das WAL wieder herSQLITE_LOCKED_SHAREDCACHEDatensatz im gemeinsamen Cache gesperrtSQLITE_CONSTRAINT_CHECKCHECK-Constraint fehlgeschlagenSQLITE_ABORT_ROLLBACKAnweisung durch ROLLBACK abgebrochenSQLITE_BUSY_SNAPSHOTein veralteter Lesevorgang kann nicht zu einem Schreibvorgang werdenSQLITE_IOERR_SHORT_READLesevorgang lieferte weniger Bytes zurückSQLITE_CANTOPEN_ISDIRder Pfad ist ein Verzeichnis
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.
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.