// Referencia de errores de SQL Server

Error 1505 de SQL Server: se encontró una clave duplicada, índice único

No se puede crear un índice único o una restricción porque la tabla ya contiene valores duplicados en esas columnas. El mensaje muestra uno de ellos.

Número de error
1505
Gravedad
16
Categoría
Restricciones y claves
Mensaje de error
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.

Qué significa

Antes de que se pueda crear un índice único, una clave primaria o una restricción única, cada fila existente debe tener una clave distinta. Si los datos ya contienen duplicados, la creación se detiene con el error 1505 y muestra un valor duplicado. Normalmente, sigue el error 1750 cuando el índice era parte de una restricción.

Causas comunes

  • Filas duplicadas que se colaron antes de que se añadiera la regla de unicidad.
  • Múltiples NULLs en una columna que estás haciendo única (SQL Server cuenta los NULLs como iguales en índices únicos).

Cómo solucionarlo

  1. Encontrar todas las claves duplicadas.

    SELECT Email, COUNT(*) AS n FROM dbo.Customers GROUP BY Email HAVING COUNT(*) > 1;
  2. Elimina o combina los duplicados y conserva una fila por clave.

    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. Si se deben permitir muchos NULL, crea un índice único filtrado (WHERE Email IS NOT NULL).

Errores relacionados

Más errores de restricciones y claves

El código y el texto del mensaje son de Referencia de eventos y errores del motor de base de datos de Microsoft. Explora la lista completa de Lista de errores de SQL Server o buscar cada error de base de datos.

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

Trabajar con SQL Server 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 SQL Server y las demás bases de datos que uses.