// SQLite-Fehlerreferenz

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
Fehlermeldung
constraint failed

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 NULL Spalte, oft weil das INSERT die Spalte weglässt und sie keinen Standardwert hat.
  • Ein Wert, der eine CHECK Ausdruck.
  • Eine Kindzeile, deren übergeordnete Zeile nicht existiert, mit PRAGMA foreign_keys = ON.
  • Ein Wert des falschen Typs in einer STRICT Tabelle.

Wie du es behebst

  1. 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';
  2. 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;
  3. 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

Weitere Fehler bei primären Ergebniscodes

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.

// weniger Fehler, schnellere Korrekturen

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.