SQL Server エラー 2627: PRIMARY KEY または UNIQUE KEY の違反
INSERT または UPDATE で、PRIMARY KEY または UNIQUE 制約の値が重複します。メッセージには制約名、テーブル名、重複したキー値が示されます。
- エラー番号
2627- 重大度
- 14
- カテゴリ
- 制約とキー
意味
主キー制約と一意制約により、2 つの行が同じキーを持たないことが保証されます。書き込みによって重複が生じる場合、SQL Server はステートメントをエラー 2627 で停止し、続いて 3621(「ステートメントは終了されました」)を返します。メッセージには、どの種類の制約か(PRIMARY KEY または UNIQUE KEY)、その名前、テーブル、そして SQL Server 2017 以降では重複した値そのもの。
エラー 2601 は、制約ではない一意インデックスで起きる同じ失敗です。
よくある原因
- すでに存在するキーを持つ行を挿入する(たとえばロードの再実行)。
- ID 列に明示的な値を挿入する(次の場合)
IDENTITY_INSERTオンの場合、または既存の値より下に ID シードがリセットされた場合。 - ソース自体に重複キーが含まれるバッチ挿入。
- 同じキーを同時に挿入する 2 つのセッション: 確認してから挿入するパターン (
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;
-
同時実行下でも安全なアップサートでは、まず更新し、何も更新されなかった場合に挿入します。その際、範囲ロックを保持します。
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; -
ID 列で値が衝突する場合は、確認して再シードしてください。
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 は PRIMARY KEY または UNIQUE 制約によって発生し、2601 は CREATE UNIQUE INDEX で作成した一意インデックスによって発生します。原因と対処は同じです。
SQL Server に重複キーを無視させることはできますか?
WITH (IGNORE_DUP_KEY = ON) で作成されたユニークインデックスは、INSERT で重複する行を、ステートメントを失敗させずに警告付きで破棄します。データが黙って捨てられるため、意図して使ってください。
関連エラー
2601重複するキー行を挿入できません547制約と競合したステートメント515NULL 値を列に挿入できません23505PostgreSQL: 重複キーが一意制約に違反しています1062MySQL: キーの重複エントリORA-00001Oracle: 一意制約違反ですSQLITE_CONSTRAINT_PRIMARYKEYSQLite: PRIMARY KEY 制約に違反しました
その他の制約とキーのエラー
3726DROP できません: 外部キーから参照されています1913インデックスまたは統計の名前がすでに存在します1750制約やインデックスを作成できません4712参照されているテーブルを TRUNCATE することはできません1505重複キーを検出 (一意インデックス)
コードとメッセージのテキストは、 Microsoft Database Engine のイベントとエラーのリファレンス。全容は次で参照 SQL Server エラー一覧 または すべてのデータベースエラーを検索.
SQLly で SQL Server を操作する
macOS、Windows、Linux 用のネイティブ SQL クライアント。スキーマを認識する IntelliSense、危険なステートメントへのガードレール、分かりやすいエラーメッセージを備え、SQL Server をはじめ、お使いの他のデータベースにも対応します。