PostgreSQL 23503: Verletzung der Fremdschlüsseleinschränkung
Eine Zeile verweist auf einen übergeordneten Schlüssel, der nicht existiert, oder Sie haben eine übergeordnete Zeile gelöscht oder geändert, auf die Kind-Zeilen noch verweisen.
- SQLSTATE
23503- Name
foreign_key_violation- Kategorie
- Integritätsbedingungsverletzung
Was es bedeutet
Ein Fremdschlüssel besagt, dass jeder Wert in der Kindspalte in der referenzierten (übergeordneten) Spalte existieren muss. PostgreSQL wirft 23503 in zwei Richtungen: wenn du eine Kindzeile einfügst oder aktualisierst, deren Schlüssel kein übergeordnetes Element hat (is not present in table), und wenn du eine übergeordnete Zeile löschst oder aktualisierst, auf die untergeordnete Zeilen noch verweisen (is still referenced from table).
das DETAIL Die Zeile nennt den Schlüsselwert und die andere Tabelle, sodass du weißt, welche Zeilen du dir anschauen musst.
Häufige Ursachen
- Einfügen von Kindzeilen vor ihren übergeordneten Zeilen, zum Beispiel beim Laden
ordersvorcustomers. - Ein Tippfehler oder eine veraltete ID in der untergeordneten Zeile.
- Löschen einer übergeordneten Zeile, die noch Kinder hat, ohne
ON DELETE CASCADEoderSET NULLauf dem Fremdschlüssel. - Aktualisieren des Primärschlüssels einer übergeordneten Zeile, während untergeordnete Zeilen den alten Wert referenzieren.
- Zwei Transaktionen: die eine fügt einen Kind-Datensatz für einen übergeordneten Datensatz ein, den die andere gerade gelöscht hat.
Wie du es behebst
-
Finde den fehlenden übergeordneten Datensatz oder die verbleibenden Kindzeilen.
SELECT * FROM customers WHERE id = 42; SELECT * FROM orders WHERE customer_id = 42;
-
Füge zuerst übergeordnete Zeilen ein oder lade beide Tabellen in einer Transaktion mit zurückgestellter Einschränkung (sie muss deklariert werden als
DEFERRABLE).ALTER TABLE orders ALTER CONSTRAINT orders_customer_id_fkey DEFERRABLE INITIALLY IMMEDIATE; BEGIN; SET CONSTRAINTS orders_customer_id_fkey DEFERRED; INSERT INTO orders (id, customer_id) VALUES (1, 42); INSERT INTO customers (id, name) VALUES (42, 'Ada'); COMMIT; -- checked here
-
Beim Löschen einer übergeordneten Zeile zuerst deren untergeordnete Zeilen löschen oder neu zuweisen, oder die Löschregel des Fremdschlüssels ändern, wenn das das gewünschte Verhalten ist.
ALTER TABLE orders DROP CONSTRAINT orders_customer_id_fkey, ADD CONSTRAINT orders_customer_id_fkey FOREIGN KEY (customer_id) REFERENCES customers (id) ON DELETE CASCADE; -
Finde verwaiste Zeilen, bevor du einen Fremdschlüssel zu bestehenden Daten hinzufügst.
SELECT o.* FROM orders o LEFT JOIN customers c ON c.id = o.customer_id WHERE o.customer_id IS NOT NULL AND c.id IS NULL;
Sicher reproduzieren
CREATE TEMP TABLE p (id int PRIMARY KEY); CREATE TEMP TABLE c (p_id int REFERENCES p (id)); INSERT INTO c VALUES (1); -- ERROR: ... violates foreign key constraint "c_p_id_fkey"
Zugehörige Fehler
23505Doppelter Schlüssel verletzt Unique-Constraint23502null-Wert verletzt Nicht-Null-Bedingung42830ungültiger Fremdschlüssel2BP01abhängige Objekte existieren noch547SQL Server: Anweisung stand in Konflikt mit einer Einschränkung1452MySQL: Fremdschlüssel schlägt fehl: kann untergeordnete Zeile nicht hinzufügen1451MySQL: Fremdschlüssel schlägt fehl: kann übergeordnete Zeile nicht löschenORA-02291Oracle: Integritäts-Constraint verletzt - kein übergeordneter SchlüsselORA-02292Oracle: Integritäts-Constraint verletzt - untergeordneter Datensatz gefundenSQLITE_CONSTRAINT_FOREIGNKEYSQLite: FOREIGN KEY-Constraint fehlgeschlagen
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.
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.