// Référence des erreurs Oracle

ORA-00001 : contrainte unique violée

Un INSERT ou UPDATE dupliquerait une valeur dans une clé primaire, une contrainte unique ou un index. Le message nomme la contrainte sous la forme SCHEMA.NAME.

Code d'erreur
ORA-00001
Catégorie
Contraintes et clés
Message d'erreur
unique constraint (string.string) violated

Ce que cela signifie

ORA-00001 signifie que l'instruction créerait une deuxième ligne avec la même clé pour une clé primaire, une contrainte unique ou un index unique. Le message indique le nom de la contrainte, par exemple ORA-00001: unique constraint (SALES.ORDERS_PK) violated; recherchez-le pour voir ses colonnes.

Les versions plus récentes indiquent également la table et les colonnes : unique constraint (constraint_schema.constraint_name) violated on table table_schema.table_name columns (column_names).

Causes courantes

  • Insertion d'une ligne dont la clé existe déjà, par exemple lors de la réexécution d'un chargement.
  • Une séquence qui est en retard par rapport aux données, donc NEXTVAL produit un id déjà présent dans la table, généralement après que des données ont été importées avec des ids explicites.
  • Deux sessions insérant simultanément la même clé ; la deuxième attend puis échoue si la première est validée.
  • Une UPDATE qui met une colonne unique à une valeur qu'une autre ligne possède.

Comment le corriger

  1. Trouvez les colonnes derrière la contrainte nommée dans le message.

    SELECT table_name, column_name, position
    FROM all_cons_columns
    WHERE owner = 'SALES' AND constraint_name = 'ORDERS_PK'
    ORDER BY position;
  2. Insérer ou mettre à jour en une seule instruction avec 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. Si une séquence est en retard, placez-la au-delà du maximum actuel (18c et ultérieures).

    SELECT MAX(id) FROM orders;
    ALTER SEQUENCE orders_seq RESTART START WITH 100001;
  4. Pour ignorer les doublons lors d'une insertion en masse, le IGNORE_ROW_ON_DUPKEY_INDEX hint ou la journalisation des erreurs DML (LOG ERRORS INTO) peut mettre de côté les lignes incorrectes.

Reproduisez-le en toute sécurité

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;

Erreurs liées

Plus d'erreurs de contraintes et de clés

Le code et le texte du message sont issus de Aide sur les erreurs Oracle Database. Parcourir la liste complète Liste des erreurs Oracle ou Rechercher toutes les erreurs de base de données.

// moins d'erreurs, corrections plus rapides

Travailler sur Oracle dans SQLly

Un client SQL natif pour macOS, Windows et Linux avec IntelliSense conscient du schéma, des garde-fous pour les instructions risquées et des messages d'erreur clairs, pour Oracle et les autres bases de données que vous utilisez.