// Referência de erro do SQL Server

Erro do SQL Server 2601: Não é possível inserir linha de chave duplicada

Um INSERT ou UPDATE colocaria um valor duplicado em um índice único. A mensagem informa a tabela, o índice e o valor da chave duplicada.

Número do erro
2601
Gravidade
14
Categoria
Restrições e chaves
Mensagem de erro
Cannot insert duplicate key row in object '%.*ls' with unique index '%.*ls'. The duplicate key value is %ls.

O que significa

O erro 2601 é gerado por um índice único criado com CREATE UNIQUE INDEX, incluindo índices únicos filtrados. É o equivalente para índices do erro 2627, que vem das restrições PRIMARY KEY e UNIQUE. A instrução para e suas alterações são revertidas.

Causas comuns

  • Escrever um valor que outra linha já possui em uma coluna coberta por um índice único.
  • Um índice único em uma coluna que permite nulos: o SQL Server trata NULLs como iguais em índices únicos, então apenas uma linha pode ter NULL a menos que o índice seja filtrado.
  • Uma carga cuja origem contém duplicatas.

Como corrigir

  1. Encontre a linha em conflito com o valor da mensagem e atualize-a ou ignore a nova.

    SELECT * FROM dbo.Users WHERE UserName = N'ada';
  2. Para permitir vários NULLs mas manter os valores não NULL únicos, use um índice filtrado.

    DROP INDEX UX_Users_TaxId ON dbo.Users;
    CREATE UNIQUE INDEX UX_Users_TaxId ON dbo.Users (TaxId) WHERE TaxId IS NOT NULL;
  3. Verifique quais colunas o índice abrange.

    EXEC sp_helpindex 'dbo.Users';

Reproduza com segurança

CREATE TABLE #u (v int NULL);
CREATE UNIQUE INDEX ux ON #u (v);
INSERT INTO #u VALUES (NULL);
INSERT INTO #u VALUES (NULL);  -- Msg 2601: The duplicate key value is (<NULL>).
DROP TABLE #u;

Perguntas

Por que não posso inserir um segundo NULL em uma coluna única?

No SQL Server, um índice ou restrição exclusiva trata NULL como um valor, então apenas um NULL é permitido. Um índice exclusivo filtrado com WHERE column IS NOT NULL permite qualquer número de NULLs.

Erros relacionados

Mais erros de restrições e chaves

O código e o texto da mensagem são de Referência de eventos e erros do Microsoft Database Engine. Veja toda a Lista de erros do SQL Server ou pesquise todos os erros do banco de dados.

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

Trabalhe com SQL Server 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 SQL Server e os outros bancos de dados que você usa.