// SQLite-Fehlerreferenz

SQLITE_CONSTRAINT_CHECK: CHECK-Einschränkung fehlgeschlagen

Eine Zeile hat einen CHECK-Ausdruck in der Tabelle nicht bestanden. Die Meldung nennt den Constraint oder zeigt den Ausdruck an, wenn der Constraint keinen Namen hat.

Ergebniscode
SQLITE_CONSTRAINT_CHECK
Name
275
Kategorie
Erweiterte Ergebnis-Codes
Fehlermeldung
CHECK constraint failed: price_positive

Was es bedeutet

SQLITE_CONSTRAINT_CHECK (275) bedeutet, dass ein Wert einen CHECK Ausdruck als falsch ausgewertet hat. Benenne deine Constraints (CONSTRAINT price_positive CHECK (price > 0)) sagt dir die Meldung also, welche Regel fehlgeschlagen ist; bei einer unbenannten Constraint geben aktuelle Versionen von SQLite stattdessen den Ausdruck aus.

Ein CHECK, der NULL ergibt, gilt als erfüllt, also CHECK (price > 0) weist keinen NULL-Preis ab.

Häufige Ursachen

  • Ein Wert außerhalb des zulässigen Bereichs oder der Liste.
  • Text, der nicht zu einem Muster passt, wie zum Beispiel CHECK (email LIKE '%@%').
  • Ein CHECK, der ein Enum oder Boolean nachbildet, bei einem unerwarteten Wert.

Wie du es behebst

  1. Sieh dir die Constraint-Definition an.

    SELECT sql FROM sqlite_schema WHERE name = 'products';
  2. Korrigiere den Wert oder ändere die Regel, wenn die Daten richtig und die Regel falsch ist. SQLite kann ein CHECK nicht direkt ändern; baue die Tabelle mit der neuen Definition neu.

  3. Benenne Constraints so, dass Fehler leicht lesbar sind.

    CREATE TABLE products (
        id    INTEGER PRIMARY KEY,
        price REAL NOT NULL CONSTRAINT price_positive CHECK (price > 0)
    );

Zugehörige Fehler

Weitere Fehler bei erweiterten 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.