// SQL Server 错误参考

SQL Server 错误 2601:无法插入重复键行

INSERT 或 UPDATE 会将重复值放入唯一索引中。消息会指明表、索引和重复键值。

错误编号
2601
严重性
14
类别
约束与键
错误信息
Cannot insert duplicate key row in object '%.*ls' with unique index '%.*ls'. The duplicate key value is %ls.

它的意思

错误 2601 由唯一索引引发,该索引创建时用了 CREATE UNIQUE INDEX,包括筛选的唯一索引。它是 2627 在索引上的对应版本,2627 来自 PRIMARY KEY 和 UNIQUE 约束。语句会停止,其更改被回滚。

常见原因

  • 向唯一索引覆盖的列写入另一行已有的值。
  • 可空列上的唯一索引:SQL Server 在唯一索引中将 NULL 视为相等,因此除非索引经过筛选,否则只有一行可以包含 NULL。
  • 来源包含重复数据的加载。

如何修复它

  1. 用消息中给出的值找到冲突的行,然后更新它或跳过新行。

    SELECT * FROM dbo.Users WHERE UserName = N'ada';
  2. 为了允许多个 NULL,同时保持非 NULL 值唯一,可以创建筛选索引。

    DROP INDEX UX_Users_TaxId ON dbo.Users;
    CREATE UNIQUE INDEX UX_Users_TaxId ON dbo.Users (TaxId) WHERE TaxId IS NOT NULL;
  3. 检查索引覆盖了哪些列。

    EXEC sp_helpindex 'dbo.Users';

安全地复现它

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;

问题

为什么我不能向有唯一约束的列插入第二个 NULL?

在 SQL Server 中,唯一索引或约束将 NULL 视为一个值,因此只允许一个 NULL。带有 WHERE column IS NOT NULL 的筛选唯一索引允许任意数量的 NULL。

相关错误

更多约束和键错误

代码和消息文本来自 Microsoft 数据库引擎事件和错误参考。浏览完整的 SQL Server 错误列表 或者 搜索每个数据库错误.

// 错误更少,修复更快

在 SQLly 中使用 SQL Server

适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 SQL Server 以及你使用的其他数据库。