// SQL Server 错误参考

SQL Server 错误 2627:违反 PRIMARY KEY 或 UNIQUE KEY 约束

INSERT 或 UPDATE 会在 PRIMARY KEY 或 UNIQUE 约束中产生重复值。消息会给出约束、表和重复的键值。

错误编号
2627
严重性
14
类别
约束与键
错误信息
Violation of %ls constraint '%.*ls'. Cannot insert duplicate key in object '%.*ls'. The duplicate key value is %ls.

它的意思

主键和唯一约束保证没有两行共享相同的键。当写入操作会产生重复时,SQL Server 会停止执行语句并返回 2627 错误,随后是 3621("语句已终止")。消息会显示约束类型(PRIMARY KEY 或者 UNIQUE KEY)、约束名称、所在的表,而且从 SQL Server 2017 起,还有重复的值本身。

错误 2601 是同一个错误,只不过发生在不作为约束的唯一索引上。

常见原因

  • 插入键已经存在的行,例如重新执行数据加载。
  • 向标识列插入显式值,且 IDENTITY_INSERT 开启时,或者将标识种子重置为低于现有值时。
  • 一次批量插入,而数据源本身就含有重复键。
  • 两个会话并发插入同一个键:先检查后插入的模式(IF NOT EXISTS ... INSERT)在没有锁定提示的情况下并不安全。

如何修复它

  1. 使用消息中显示的值查找现有行。

    SELECT * FROM dbo.Customers WHERE Email = N'[email protected]';
  2. 在加载时跳过已经存在的行。

    INSERT INTO dbo.Customers (Email, Name)
    SELECT s.Email, s.Name
    FROM staging.Customers AS s
    WHERE NOT EXISTS (SELECT 1 FROM dbo.Customers AS c WHERE c.Email = s.Email);
  3. 在插入之前检查源中是否有重复。

    SELECT Email, COUNT(*) FROM staging.Customers GROUP BY Email HAVING COUNT(*) > 1;
  4. 对于并发下安全的 upsert,先更新,没有更新到任何行再插入,同时持有范围锁。

    BEGIN TRANSACTION;
    UPDATE dbo.Customers WITH (UPDLOCK, SERIALIZABLE) SET Name = @Name WHERE Email = @Email;
    IF @@ROWCOUNT = 0
        INSERT INTO dbo.Customers (Email, Name) VALUES (@Email, @Name);
    COMMIT;
  5. 如果标识列冲突,请检查并重新设置种子值。

    DBCC CHECKIDENT ('dbo.Customers', NORESEED);  -- shows current and max values
    DBCC CHECKIDENT ('dbo.Customers', RESEED);

安全地复现它

CREATE TABLE #k (id int PRIMARY KEY);
INSERT INTO #k VALUES (1);
INSERT INTO #k VALUES (1);  -- Msg 2627 ... The duplicate key value is (1).
DROP TABLE #k;

问题

错误 2627 和 2601 有什么区别?

2627 是由主键或唯一约束引发的;2601 是由使用 CREATE UNIQUE INDEX 创建的唯一索引引发的。原因和解决方法相同。

我可以让 SQL Server 忽略重复键吗?

用 WITH (IGNORE_DUP_KEY = ON) 创建的唯一索引在 INSERT 时会丢弃重复行并发出警告,而不是让整个语句失败。请想清楚再用,因为它会悄悄丢数据。

相关错误

更多约束和键错误

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

// 错误更少,修复更快

在 SQLly 中使用 SQL Server

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