SQLITE_CONSTRAINT: Einschränkung fehlgeschlagen
Ein INSERT oder UPDATE hat einen Constraint verletzt: UNIQUE, PRIMARY KEY, NOT NULL, CHECK oder FOREIGN KEY. Die Meldung und der erweiterte Code geben an, welcher.
- Ergebniscode
SQLITE_CONSTRAINT- Name
19- Kategorie
- Primäre Ergebniscodes
Was es bedeutet
SQLITE_CONSTRAINT (19) bedeutet, dass eine Anweisung eine der Regeln der Tabelle verletzt hätte, weshalb SQLite sie gestoppt hat. Der generische Text lautet constraint failed, aber die Nachricht nennt normalerweise die Regel und die Spalte, wie zum Beispiel UNIQUE constraint failed: users.email, und der erweiterte Code sagt dir die Art: SQLITE_CONSTRAINT_UNIQUE, _PRIMARYKEY, _NOTNULL, _CHECK, _FOREIGNKEY, _DATATYPE (STRICT-Tabellen) oder _TRIGGER (ein RAISE() in einem Trigger).
Standardmäßig wird die fehlgeschlagene Anweisung rückgängig gemacht (Konfliktmodus ABORT), aber frühere Anweisungen derselben Transaktion bleiben bestehen.
Häufige Ursachen
- Ein doppelter Wert in einem Primärschlüssel oder einer eindeutigen Spalte.
- Ein NULL-Wert in einer
NOT NULLSpalte, oft weil das INSERT die Spalte weglässt und sie keinen Standardwert hat. - Ein Wert, der eine
CHECKAusdruck. - Eine Kindzeile, deren übergeordnete Zeile nicht existiert, mit
PRAGMA foreign_keys = ON. - Ein Wert des falschen Typs in einer
STRICTTabelle.
Wie du es behebst
-
Lies die Meldung oder den erweiterten Code, um zu sehen, welche Einschränkung fehlgeschlagen ist, und schau dir dann die Tabellendefinition an.
SELECT sql FROM sqlite_schema WHERE name = 'users';
-
Für Duplikate, die du zusammenführen oder überspringen willst, verwende ein Upsert oder eine Konfliktklausel.
INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada') ON CONFLICT (email) DO UPDATE SET name = excluded.name; -
Bei den anderen Einschränkungen korrigierst du die Daten, die du schreibst: Liefere den fehlenden Wert nach, füge zuerst die übergeordnete Zeile ein oder korrigiere den Wert, der die Prüfung nicht besteht.
Zugehörige Fehler
SQLITE_CONSTRAINT_UNIQUEUNIQUE-Einschränkung fehlgeschlagenSQLITE_CONSTRAINT_PRIMARYKEYPRIMARY KEY-Constraint fehlgeschlagenSQLITE_CONSTRAINT_NOTNULLNOT NULL-Constraint fehlgeschlagenSQLITE_CONSTRAINT_CHECKCHECK-Constraint fehlgeschlagenSQLITE_CONSTRAINT_FOREIGNKEYFremdschlüssel-Constraint fehlgeschlagenSQLITE_CONSTRAINT_DATATYPEWert passt nicht in eine STRICT-Spalte
Weitere Fehler bei primären Ergebniscodes
SQLITE_ERRORSQL-LogikfehlerSQLITE_PERMZugriffsberechtigung verweigertSQLITE_ABORTAbfrage abgebrochenSQLITE_BUSYDatenbank ist gesperrtSQLITE_LOCKEDDatenbanktabelle ist gesperrtSQLITE_NOMEMkein Speicher mehrSQLITE_READONLYVersuch, in eine schreibgeschützte Datenbank zu schreibenSQLITE_INTERRUPTunterbrochen
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.