// 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、フィルター付き一意インデックスを含みます。PRIMARY KEY や UNIQUE 制約で発生する 2627 に対応する、インデックス側のエラーです。ステートメントは停止し、その変更はロールバックされます。

よくある原因

  • 別の行が既に持っている値を、ユニークインデックスの対象になっている列に書き込むこと。
  • NULL 可能な列のユニークインデックス: SQL Server はユニークインデックスで NULL 同士を等しいものとして扱うため、インデックスがフィルター付きでない限り、NULL を持てるのは 1 行だけです。
  • ソースに重複が含まれているロード。

修正方法

  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;

質問

一意の列に 2 つ目の NULL を挿入できないのはなぜですか?

SQL Server では、一意インデックスまたは制約は NULL を 1 つの値として扱うため、NULL は 1 つしか許可されません。WHERE column IS NOT NULL を付けたフィルター付き一意インデックスなら、NULL をいくつでも許可できます。

関連エラー

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

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

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

SQLly で SQL Server を操作する

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