// 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.

意味

主キー制約と一意制約により、2 つの行が同じキーを持たないことが保証されます。書き込みによって重複が生じる場合、SQL Server はステートメントをエラー 2627 で停止し、続いて 3621(「ステートメントは終了されました」)を返します。メッセージには、どの種類の制約か(PRIMARY KEY または UNIQUE KEY)、その名前、テーブル、そして SQL Server 2017 以降では重複した値そのもの。

エラー 2601 は、制約ではない一意インデックスで起きる同じ失敗です。

よくある原因

  • すでに存在するキーを持つ行を挿入する(たとえばロードの再実行)。
  • ID 列に明示的な値を挿入する(次の場合) IDENTITY_INSERT オンの場合、または既存の値より下に ID シードがリセットされた場合。
  • ソース自体に重複キーが含まれるバッチ挿入。
  • 同じキーを同時に挿入する 2 つのセッション: 確認してから挿入するパターン (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. 同時実行下でも安全なアップサートでは、まず更新し、何も更新されなかった場合に挿入します。その際、範囲ロックを保持します。

    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. 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 で重複する行を、ステートメントを失敗させずに警告付きで破棄します。データが黙って捨てられるため、意図して使ってください。

関連エラー

その他の制約とキーのエラー

コードとメッセージのテキストは、 Microsoft Database Engine のイベントとエラーのリファレンス。全容は次で参照 SQL Server エラー一覧 または すべてのデータベースエラーを検索.

// エラーが減り、修正も速く

SQLly で SQL Server を操作する

macOS、Windows、Linux 用のネイティブ SQL クライアント。スキーマを認識する IntelliSense、危険なステートメントへのガードレール、分かりやすいエラーメッセージを備え、SQL Server をはじめ、お使いの他のデータベースにも対応します。