// SQL Server 错误参考
SQL Server 错误 2627:违反 PRIMARY KEY 或 UNIQUE KEY 约束
INSERT 或 UPDATE 会在 PRIMARY KEY 或 UNIQUE 约束中产生重复值。消息会给出约束、表和重复的键值。
- 错误编号
2627- 严重性
- 14
- 类别
- 约束与键
它的意思
主键和唯一约束保证没有两行共享相同的键。当写入操作会产生重复时,SQL Server 会停止执行语句并返回 2627 错误,随后是 3621("语句已终止")。消息会显示约束类型(PRIMARY KEY 或者 UNIQUE KEY)、约束名称、所在的表,而且从 SQL Server 2017 起,还有重复的值本身。
错误 2601 是同一个错误,只不过发生在不作为约束的唯一索引上。
常见原因
- 插入键已经存在的行,例如重新执行数据加载。
- 向标识列插入显式值,且
IDENTITY_INSERT开启时,或者将标识种子重置为低于现有值时。 - 一次批量插入,而数据源本身就含有重复键。
- 两个会话并发插入同一个键:先检查后插入的模式(
IF NOT EXISTS ... INSERT)在没有锁定提示的情况下并不安全。
如何修复它
-
使用消息中显示的值查找现有行。
SELECT * FROM dbo.Customers WHERE Email = N'[email protected]';
-
在加载时跳过已经存在的行。
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);
-
在插入之前检查源中是否有重复。
SELECT Email, COUNT(*) FROM staging.Customers GROUP BY Email HAVING COUNT(*) > 1;
-
对于并发下安全的 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; -
如果标识列冲突,请检查并重新设置种子值。
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 时会丢弃重复行并发出警告,而不是让整个语句失败。请想清楚再用,因为它会悄悄丢数据。
相关错误
2601无法插入重复键行547语句与约束冲突515无法将值 NULL 插入列23505PostgreSQL:重复键违反唯一约束1062MySQL:键的重复条目ORA-00001Oracle:违反唯一约束SQLITE_CONSTRAINT_PRIMARYKEYSQLite:主键约束失败
更多约束和键错误
代码和消息文本来自 Microsoft 数据库引擎事件和错误参考。浏览完整的 SQL Server 错误列表 或者 搜索每个数据库错误.
// 错误更少,修复更快
在 SQLly 中使用 SQL Server
适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 SQL Server 以及你使用的其他数据库。