// Referencia de errores de SQL Server

Error 2601 de SQL Server: no se puede insertar una fila de clave duplicada

Un INSERT o UPDATE pondría un valor duplicado en un índice único. El mensaje nombra la tabla, el índice y el valor duplicado de la clave.

Número de error
2601
Gravedad
14
Categoría
Restricciones y claves
Mensaje de error
Cannot insert duplicate key row in object '%.*ls' with unique index '%.*ls'. The duplicate key value is %ls.

Qué significa

El error 2601 lo provoca un índice único creado con CREATE UNIQUE INDEX, incluidos los índices únicos filtrados. Es el equivalente para índices del error 2627, que proviene de las restricciones PRIMARY KEY y UNIQUE. La instrucción se detiene y sus cambios se revierten.

Causas comunes

  • Escribir un valor que otra fila ya tiene en una columna cubierta por un índice único.
  • Un índice único en una columna que admite NULL: SQL Server trata los NULL como iguales en los índices únicos, así que solo una fila puede tener NULL, salvo que el índice sea filtrado.
  • Una carga cuya fuente contiene duplicados.

Cómo solucionarlo

  1. Encuentra la fila en conflicto con el valor del mensaje, luego actualízala u omite la nueva.

    SELECT * FROM dbo.Users WHERE UserName = N'ada';
  2. Para permitir muchos NULL pero mantener los valores no NULL únicos, haz que el índice esté 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. Verifica qué columnas cubre el índice.

    EXEC sp_helpindex 'dbo.Users';

Reprodúcelo de forma segura

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;

Preguntas

¿Por qué no puedo insertar un segundo NULL en una columna única?

En SQL Server, un índice o restricción única trata NULL como un valor, así que solo se permite un NULL. Un índice único filtrado con WHERE column IS NOT NULL admite cualquier número de 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.