// PostgreSQL-Fehlerreferenz

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
Fehlermeldung
duplicate key value violates unique constraint "users_email_key"
DETAIL:  Key (email)=([email protected]) already exists.

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 serial oder 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 Klassiker Key (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 UPDATE das eine eindeutige Spalte auf einen Wert setzt, den eine andere Zeile bereits hat.

Wie du es behebst

  1. Finde die vorhandene Zeile, die in der DETAIL Zeile, und entscheide, ob die neuen Daten ein Duplikat oder ein anderer Datensatz sind.

    SELECT * FROM users WHERE email = '[email protected]';
  2. 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;
  3. 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;
  4. Wenn das Duplikat auf einem serial oder 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

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.