PostgreSQL 23505: doppelter Schlüssel verletzt eindeutige Einschränkung
Ein INSERT oder UPDATE würde eine zweite Zeile mit demselben Wert in einer Spalte erzeugen, die von einem Primärschlüssel, einem eindeutigen Constraint oder einem eindeutigen Index abgedeckt wird.
- SQLSTATE
23505- Name
unique_violation- Kategorie
- Integritätsbedingungsverletzung
Was es bedeutet
PostgreSQL erzwingt jeden Primärschlüssel, UNIQUE Einschränkung und eindeutiger Index zum Zeitpunkt, an dem eine Zeile geschrieben wird. Wenn die neue oder geänderte Zeile denselben Schlüssel wie eine bereits vorhandene Zeile hat (oder eine, die eine andere Transaktion geschrieben, aber noch nicht committet hat), schlägt die Anweisung mit 23505 fehl, und nichts von den Änderungen bleibt erhalten.
das DETAIL Die Zeile nennt die Spalte und den doppelten Wert, und die Meldung nennt die Einschränkung oder den Index, was dir genau sagt, welche Regel verletzt wurde.
Häufige Ursachen
- Einfügen einer Zeile, deren Schlüssel bereits existiert, zum Beispiel beim erneuten Ausführen eines Imports oder eines Seed-Skripts.
- A
serialoder Identitätssequenz, die hinter den Daten zurückliegt, meist nachdem Zeilen mit expliziten IDs geladen wurden. Die nächste Standard-ID kollidiert mit einer vorhandenen Zeile: der KlassikerKey (id)=(1) already exists. - Zwei Sitzungen fügen gleichzeitig denselben Schlüssel ein; die zweite wartet auf die erste und schlägt fehl, sobald die erste committet.
- Eine
UPDATEdas eine eindeutige Spalte auf einen Wert setzt, den eine andere Zeile bereits hat.
Wie du es behebst
-
Finde die vorhandene Zeile, die in der
DETAILZeile, und entscheide, ob die neuen Daten ein Duplikat oder ein anderer Datensatz sind.SELECT * FROM users WHERE email = '[email protected]';
-
Soll der Schreibvorgang stattdessen die vorhandene Zeile aktualisieren, mach daraus einen Upsert mit
ON CONFLICT.INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada') ON CONFLICT (email) DO UPDATE SET name = EXCLUDED.name; -
Wenn Duplikate einfach übersprungen werden sollen, verwende
ON CONFLICT DO NOTHING.INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada') ON CONFLICT (email) DO NOTHING; -
Wenn das Duplikat auf einem
serialoder Identitäts-ID liegt, schiebe die Sequenz über den höchsten vorhandenen Wert hinaus.SELECT setval(pg_get_serial_sequence('users', 'id'), (SELECT COALESCE(MAX(id), 0) + 1 FROM users), false);
Sicher reproduzieren
CREATE TEMP TABLE t (id int PRIMARY KEY); INSERT INTO t VALUES (1); INSERT INTO t VALUES (1); -- ERROR: duplicate key value violates unique constraint "t_pkey"
Fragen
Warum schlägt das Einfügen mit einem doppelten Schlüssel in der id-Spalte fehl, wenn ich die id nie gesetzt habe?
Die Sequenz der Tabelle hinkt den Daten hinterher, meist weil Zeilen mit expliziten IDs eingefügt oder ohne den Sequenzwert wiederhergestellt wurden. Setze sie zurück mit setval auf eins nach MAX(id).
Funktioniert ON CONFLICT mit einem beliebigen eindeutigen Index?
Es funktioniert mit den Spalten eines eindeutigen Index oder einer eindeutigen Einschränkung, oder mit ON CONFLICT ON CONSTRAINT name. Es benötigt PostgreSQL 9.5 oder neuer.
Zugehörige Fehler
23503Fremdschlüssel-Constraint-Verletzung23502null-Wert verletzt Nicht-Null-Bedingung25P02Die aktuelle Transaktion wurde abgebrochen2627SQL Server: Verletzung von PRIMARY KEY oder UNIQUE KEY2601SQL Server: Kann keine doppelte Schlüsselzeile einfügen1062MySQL: Doppelter Eintrag für SchlüsselORA-00001Oracle: Unique-Constraint verletztSQLITE_CONSTRAINT_UNIQUESQLite: UNIQUE-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.