// Referência de erro do Oracle

ORA-00001: violação de restrição única

Um INSERT ou UPDATE duplicaria um valor em uma chave primária, restrição única ou índice. A mensagem nomeia a restrição como SCHEMA.NAME.

Código de erro
ORA-00001
Categoria
Restrições e chaves
Mensagem de erro
unique constraint (string.string) violated

O que significa

ORA-00001 significa que a instrução criaria uma segunda linha com a mesma chave em uma chave primária, restrição única ou índice único. A mensagem nomeia a restrição, por exemplo ORA-00001: unique constraint (SALES.ORDERS_PK) violated; procure-a para ver suas colunas.

Versões mais recentes também indicam a tabela e as colunas: unique constraint (constraint_schema.constraint_name) violated on table table_schema.table_name columns (column_names).

Causas comuns

  • Inserindo uma linha cuja chave já existe, por exemplo, ao reexecutar um carregamento.
  • Uma sequência que está atrasada em relação aos dados, então NEXTVAL produz um ID já existente na tabela, tipicamente depois que dados foram importados com IDs explícitos.
  • Duas sessões inserindo a mesma chave ao mesmo tempo; a segunda espera e então falha se a primeira fizer commit.
  • Uma UPDATE que define uma coluna única com um valor que outra linha já possui.

Como corrigir

  1. Encontre as colunas da restrição citada na mensagem.

    SELECT table_name, column_name, position
    FROM all_cons_columns
    WHERE owner = 'SALES' AND constraint_name = 'ORDERS_PK'
    ORDER BY position;
  2. Insira ou atualize em uma instrução com 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. Se uma sequência estiver atrasada, mova-a além do máximo atual (18c e posteriores).

    SELECT MAX(id) FROM orders;
    ALTER SEQUENCE orders_seq RESTART START WITH 100001;
  4. Para pular duplicatas em uma inserção em massa, o IGNORE_ROW_ON_DUPKEY_INDEX hint ou o registro de erro DML (LOG ERRORS INTO) pode separar as linhas inválidas.

Reproduza com segurança

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;

Erros relacionados

Mais erros de restrições e chaves

O código e o texto da mensagem são de Ajuda de erros do Oracle Database. Veja toda a Lista de erros do Oracle ou pesquise todos os erros do banco de dados.

// menos erros, correções mais rápidas

Trabalhe com Oracle no SQLly

Um cliente SQL nativo para macOS, Windows e Linux com IntelliSense que conhece o esquema, proteções para instruções arriscadas e mensagens de erro claras, para o Oracle e os outros bancos de dados que você usa.