// Referencia de errores de Oracle

ORA-00001: restricción única violada

Un INSERT o UPDATE duplicaría un valor en una clave primaria o en una restricción o índice único. El mensaje nombra la restricción como SCHEMA.NAME.

Código de error
ORA-00001
Categoría
Restricciones y claves
Mensaje de error
unique constraint (string.string) violated

Qué significa

ORA-00001 significa que la instrucción crearía una segunda fila con la misma clave en una clave primaria, una restricción única o un índice único. El mensaje nombra la restricción, por ejemplo ORA-00001: unique constraint (SALES.ORDERS_PK) violated; búscala para ver sus columnas.

Las versiones más recientes también nombran la tabla y las columnas: unique constraint (constraint_schema.constraint_name) violated on table table_schema.table_name columns (column_names).

Causas comunes

  • Insertar una fila cuya clave ya existe, por ejemplo al volver a ejecutar una carga.
  • Una secuencia que va por detrás de los datos, así que NEXTVAL produce un ID que ya existe en la tabla, normalmente porque se importaron datos con IDs explícitos.
  • Dos sesiones insertan la misma clave a la vez; la segunda espera y falla si la primera confirma.
  • Una UPDATE que establece en una columna única un valor que otra fila ya tiene.

Cómo solucionarlo

  1. Encuentra las columnas que componen la restricción mencionada en el mensaje.

    SELECT table_name, column_name, position
    FROM all_cons_columns
    WHERE owner = 'SALES' AND constraint_name = 'ORDERS_PK'
    ORDER BY position;
  2. Inserta o actualiza en una sola instrucción con 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 una secuencia está retrasada, muévela más allá del máximo actual (18c y posteriores).

    SELECT MAX(id) FROM orders;
    ALTER SEQUENCE orders_seq RESTART START WITH 100001;
  4. Para omitir duplicados en una inserción masiva, la IGNORE_ROW_ON_DUPKEY_INDEX sugerencia o el registro de errores DML (LOG ERRORS INTO) pueden apartar las filas incorrectas.

Reprodúcelo de forma segura

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;

Errores relacionados

Más errores de restricciones y claves

El código y el texto del mensaje son de Ayuda para errores de Oracle Database. Explora la lista completa de Lista de errores de Oracle o buscar cada error de base de datos.

// menos errores, correcciones más rápidas

Trabajar con Oracle en SQLly

Un cliente SQL nativo para macOS, Windows y Linux con IntelliSense que conoce el esquema, protecciones para las instrucciones de riesgo y mensajes de error claros, para Oracle y las demás bases de datos que uses.