// Referência de erro do SQL Server

Erro do SQL Server 1505: Chave duplicada encontrada, índice único

Um índice ou restrição única não pode ser criado porque a tabela já contém valores duplicados nessas colunas. A mensagem mostra um deles.

Número do erro
1505
Gravidade
16
Categoria
Restrições e chaves
Mensagem de erro
The CREATE UNIQUE INDEX statement terminated because a duplicate key was found for the object name '%.*ls' and the index name '%.*ls'. The duplicate key value is %ls.

O que significa

Antes de criar um índice único, uma chave primária ou uma restrição única, cada linha existente precisa ter uma chave distinta. Se os dados já contêm duplicatas, a criação para no erro 1505 e mostra um valor duplicado. O erro 1750 geralmente vem em seguida, quando o índice fazia parte de uma restrição.

Causas comuns

  • Linhas duplicadas que entraram antes da regra de exclusividade ser adicionada.
  • Múltiplos NULLs em uma coluna que você está tornando única (o SQL Server conta NULLs como iguais em índices únicos).

Como corrigir

  1. Encontre todas as chaves duplicadas.

    SELECT Email, COUNT(*) AS n FROM dbo.Customers GROUP BY Email HAVING COUNT(*) > 1;
  2. Remova ou mescle duplicatas, mantendo uma linha por chave.

    WITH d AS (
        SELECT *, ROW_NUMBER() OVER (PARTITION BY Email ORDER BY CustomerId) AS rn FROM dbo.Customers
    )
    DELETE FROM d WHERE rn > 1;
  3. Se muitos NULLs devem ser permitidos, crie um índice exclusivo filtrado (WHERE Email IS NOT NULL).

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.