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
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
-
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';
-
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;
-
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
2627Infracción de PRIMARY KEY o UNIQUE KEY1913El nombre del índice o de las estadísticas ya existe23505PostgreSQL: la clave duplicada infringe la restricción de unicidad1062MySQL: entrada duplicada para la claveORA-00001Oracle: restricción de unicidad violada
Más errores de restricciones y claves
547La instrucción entró en conflicto con una restricción515No se puede insertar el valor NULL en la columna3726No se puede eliminar: referenciado por una FOREIGN KEY1750No se pudo crear la restricción o índice4712No se puede truncar una tabla referenciada1505Clave duplicada encontrada, índice único
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.
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.