// PostgreSQL エラーリファレンス

PostgreSQL 23505: 重複キーが一意制約に違反しています

INSERT または UPDATE で、主キー、一意制約、一意インデックスのいずれかが付いた列に、同じ値の 2 行目ができてしまいます。

SQLSTATE
23505
名前
unique_violation
カテゴリ
整合性制約違反
エラーメッセージ
duplicate key value violates unique constraint "users_email_key"
DETAIL:  Key (email)=([email protected]) already exists.

意味

PostgreSQL は、すべての主キー、 UNIQUE 制約とユニークインデックスは、行が書き込まれる瞬間に適用されます。新規または変更された行が、すでに存在する行(または別のトランザクションが書き込み済みでまだコミットしていない行)と同じキーを持つ場合、ステートメントは23505で失敗し、変更内容は何も保持されません。

その DETAIL 行には列と重複した値が示され、メッセージには制約またはインデックスの名前が示されるので、どのルールに違反したかが正確に分かります。

よくある原因

  • すでに存在するキーを持つ行を挿入する(たとえばインポートやシードスクリプトの再実行)。
  • A serial またはデータに遅れをとった ID シーケンス。通常は、行を明示的な ID でロードした後に起こります。次のデフォルト ID が既存の行と衝突します。 Key (id)=(1) already exists.
  • 同じキーを同時に挿入する 2 つのセッション。2 番目は 1 番目を待ち、1 番目がコミットした途端に失敗します。
  • ある UPDATE 一意の列を、別の行がすでに持っている値に設定するもの。

修正方法

  1. 次で名前が示されている既存の行を見つけます DETAIL 行で、新しいデータが重複か別のレコードかを判断します。

    SELECT * FROM users WHERE email = '[email protected]';
  2. 書き込みで既存の行を更新したい場合は、次を使って upsert にしてください ON CONFLICT.

    INSERT INTO users (email, name)
    VALUES ('[email protected]', 'Ada')
    ON CONFLICT (email) DO UPDATE SET name = EXCLUDED.name;
  3. 重複を単にスキップしたい場合は、次を使います ON CONFLICT DO NOTHING.

    INSERT INTO users (email, name)
    VALUES ('[email protected]', 'Ada')
    ON CONFLICT (email) DO NOTHING;
  4. 重複が次のものにある場合 serial または ID の場合、シーケンスを既存の最大値より先へ進めます。

    SELECT setval(pg_get_serial_sequence('users', 'id'),
                  (SELECT COALESCE(MAX(id), 0) + 1 FROM users), false);

安全に再現する

CREATE TEMP TABLE t (id int PRIMARY KEY);
INSERT INTO t VALUES (1);
INSERT INTO t VALUES (1);  -- ERROR: duplicate key value violates unique constraint "t_pkey"

質問

id を一度も設定していないのに、INSERT が id 列の重複キーで失敗するのはなぜですか?

テーブルのシーケンスがデータより遅れています。通常は、明示的な ID で行を挿入した場合や、シーケンスの値なしで復元した場合に起こります。次の方法でリセットします。 setval 1 つ先へ MAX(id).

ON CONFLICT は一意インデックスがあれば使えますか?

一意インデックスまたは制約の列に対して動作します。または次に対しても ON CONFLICT ON CONSTRAINT name。PostgreSQL 9.5 以降が必要です。

関連エラー

その他の整合性制約違反のエラー

コードとメッセージのテキストは、 PostgreSQL ドキュメントの付録 A: PostgreSQL エラーコード。全容は次で参照 PostgreSQL エラーリスト または すべてのデータベースエラーを検索.

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

SQLly で PostgreSQL を操作する

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