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
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
-
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';
-
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;
-
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
2627Violação de PRIMARY KEY ou UNIQUE KEY1913O nome do índice ou da estatística já existe23505PostgreSQL: chave duplicada viola a restrição de unicidade1062MySQL: entrada duplicada para a chaveORA-00001Oracle: restrição de unicidade violada
Mais erros de restrições e chaves
547A instrução entrou em conflito com uma restrição515Não é possível inserir o valor NULL na coluna3726Não é possível descartar: referenciado por uma chave estrangeira1750Não foi possível criar restrição ou índice4712Não é possível truncar uma tabela referenciada1505Chave duplicada encontrada, índice único
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.
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.