// PostgreSQL-Fehlerreferenz

PostgreSQL 23514: Verletzung der Prüfeinschränkung

Eine Zeile hat einen CHECK-Constraint auf der Tabelle oder einen Check einer Domain nicht bestanden, daher wurde das INSERT oder UPDATE abgelehnt.

SQLSTATE
23514
Name
check_violation
Kategorie
Integritätsbedingungsverletzung
Fehlermeldung
new row for relation "orders" violates check constraint "orders_qty_check"
DETAIL:  Failing row contains (12, -1).

Was es bedeutet

A CHECK Eine Einschränkung ist eine Bedingung, die jede Zeile erfüllen muss, zum Beispiel qty > 0. 23514 bedeutet, dass die neue oder aktualisierte Zeile die Bedingung falsch macht. Eine Bedingung, die zu NULL ausgewertet wird, besteht, sodass Prüfungen die NULL Werte für sich genommen nicht ablehnen.

Die Meldung nennt den Constraint; \d table_name in psql oder pg_get_constraintdef zeigt ihre Bedingung. Das Hinzufügen einer CHECK-Einschränkung zu einer Tabelle mit bestehenden fehlerhaften Zeilen schlägt auf die gleiche Weise fehl, mit check constraint ... of relation ... is violated by some row.

Häufige Ursachen

  • Daten außerhalb des erlaubten Bereichs oder der erlaubten Werte, zum Beispiel eine negative Menge oder ein unbekannter Status.
  • Anwendungsvalidierung, die von den Regeln der Datenbank abweicht.
  • Hinzufügen einer CHECK Einschränkung zu einer Tabelle, die bereits Zeilen enthält, die sie verletzen.
  • Ein Domänentyp mit einer CHECK (value for domain ... violates check constraint).

Wie du es behebst

  1. Lies die Bedingung der Einschränkung.

    SELECT conname, pg_get_constraintdef(oid)
    FROM pg_constraint
    WHERE conrelid = 'orders'::regclass AND contype = 'c';
  2. Korrigiere die zu schreibenden Daten, sodass sie die Bedingung erfüllen.

  3. Um einer Tabelle mit alten fehlerhaften Zeilen einen CHECK-Constraint hinzuzufügen, füge ihn NOT VALID (nur für neue Zeilen erzwungen) hinzu, bereinige die Daten und validiere dann.

    ALTER TABLE orders ADD CONSTRAINT orders_qty_check CHECK (qty > 0) NOT VALID;
    UPDATE orders SET qty = 1 WHERE qty <= 0;
    ALTER TABLE orders VALIDATE CONSTRAINT orders_qty_check;

Sicher reproduzieren

CREATE TEMP TABLE o (qty int CHECK (qty > 0));
INSERT INTO o VALUES (-1);  -- ERROR: new row for relation "o" violates check constraint "o_qty_check"

Zugehörige Fehler

Weitere Fehler bei der Verletzung von Integritätsbedingungen

Der Code und der Meldungstext stammen aus der PostgreSQL-Dokumentation, Anhang A: PostgreSQL-Fehlercodes. Durchstöbere die vollständige PostgreSQL-Fehlerliste oder Jeden Datenbankfehler durchsuchen.

// weniger Fehler, schnellere Korrekturen

Arbeiten mit PostgreSQL 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 PostgreSQL und die anderen Datenbanken, mit denen du arbeitest.