// Oracle-Fehlerreferenz

ORA-00001: Unique-Constraint verletzt

Ein INSERT oder UPDATE würde einen Wert in einem Primärschlüssel, einem eindeutigen Constraint oder einem eindeutigen Index duplizieren. Die Meldung nennt den Constraint in der Form SCHEMA.NAME.

Fehlercode
ORA-00001
Kategorie
Beschränkungen und Schlüssel
Fehlermeldung
unique constraint (string.string) violated

Was es bedeutet

ORA-00001 bedeutet, dass die Anweisung eine zweite Zeile mit demselben Schlüssel in einem Primärschlüssel, einem Unique-Constraint oder einem Unique-Index erzeugen würde. Die Meldung nennt den Constraint, zum Beispiel ORA-00001: unique constraint (SALES.ORDERS_PK) violated; schlage sie nach, um ihre Spalten zu sehen.

Neuere Versionen nennen auch die Tabelle und die Spalten: unique constraint (constraint_schema.constraint_name) violated on table table_schema.table_name columns (column_names).

Häufige Ursachen

  • Einfügen einer Zeile, deren Schlüssel bereits existiert, zum Beispiel beim erneuten Ausführen eines Ladevorgangs.
  • Eine Sequenz, die hinter den Daten zurückbleibt, sodass NEXTVAL eine bereits in der Tabelle vorhandene ID erzeugt, typischerweise nachdem Daten mit expliziten IDs importiert wurden.
  • Zwei Sitzungen fügen denselben Schlüssel gleichzeitig ein; die zweite wartet und schlägt dann fehl, wenn die erste committet.
  • Eine UPDATE die eine eindeutige Spalte auf einen Wert setzt, den eine andere Zeile hat.

Wie du es behebst

  1. Finde die Spalten hinter dem in der Meldung genannten Constraint.

    SELECT table_name, column_name, position
    FROM all_cons_columns
    WHERE owner = 'SALES' AND constraint_name = 'ORDERS_PK'
    ORDER BY position;
  2. Einfügen oder Aktualisieren in einer Anweisung mit MERGE.

    MERGE INTO customers c
    USING (SELECT '[email protected]' AS email, 'Ada' AS name FROM dual) s
    ON (c.email = s.email)
    WHEN MATCHED THEN UPDATE SET c.name = s.name
    WHEN NOT MATCHED THEN INSERT (email, name) VALUES (s.email, s.name);
  3. Wenn eine Sequenz hinterherhinkt, schiebe sie über den aktuellen Höchstwert hinaus (ab 18c).

    SELECT MAX(id) FROM orders;
    ALTER SEQUENCE orders_seq RESTART START WITH 100001;
  4. Um Duplikate bei einem Masseninsert zu überspringen, kann der IGNORE_ROW_ON_DUPKEY_INDEX Hinweis oder DML-Fehlerprotokollierung (LOG ERRORS INTO) die fehlerhaften Zeilen beiseitelegen.

Sicher reproduzieren

CREATE TABLE t (id NUMBER PRIMARY KEY);
INSERT INTO t VALUES (1);
INSERT INTO t VALUES (1);  -- ORA-00001: unique constraint (...) violated
DROP TABLE t PURGE;

Zugehörige Fehler

Weitere Fehler bei Constraints und Schlüsseln

Der Code und der Meldungstext stammen aus der Oracle Database Error Help. Durchstöbere die vollständige Oracle-Fehlerliste oder Jeden Datenbankfehler durchsuchen.

// weniger Fehler, schnellere Korrekturen

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