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

PostgreSQL 23P01: 除外制約違反

EXCLUDE 制約により、行が既存の行と競合しています。通常は、同じ部屋、リソース、または人物の時間範囲が重複しています。

SQLSTATE
23P01
名前
exclusion_violation
カテゴリ
整合性制約違反
エラーメッセージ
conflicting key value violates exclusion constraint "bookings_room_during_excl"
DETAIL:  Key (room_id, during)=(4, ["2026-05-01 10:00:00","2026-05-01 11:00:00")) conflicts with existing key (room_id, during)=(4, ["2026-05-01 10:30:00","2026-05-01 12:00:00")).

意味

排他制約は一意性を一般化したものです。リストされたすべての比較を同時に満たす 2 つの行は存在できません。典型的な用途は EXCLUDE USING gist (room_id WITH =, during WITH &&)、つまり、同じ部屋の 2 つの予約が、重なり合う範囲を持ってはならないという意味です。

23P01 は、新規または更新された行が、次に表示されている既存の行と競合することを意味します。 DETAIL 行。

よくある原因

  • 二重予約:新しい範囲が、同じキーの既存の範囲と重なっています。
  • 上限を含む範囲([a,b])が隣接している場合: [10:00,11:00] そして [11:00,12:00] 11:00 で重なります。デフォルトの半開形式 [a,b) これを避けられます。
  • 重なる範囲を挿入する 2 つの同時トランザクション。最初のものがコミットしたとき、2 つ目が失敗します。

修正方法

  1. 書き込む前に競合する行を探すか、どの予約が邪魔になっているかをユーザーに示します。

    SELECT * FROM bookings
    WHERE room_id = 4
      AND during && tstzrange('2026-05-01 10:00', '2026-05-01 11:00');
  2. 連続した予約が重複しないよう、半開区間を使用します。

    INSERT INTO bookings (room_id, during)
    VALUES (4, tstzrange('2026-05-01 11:00', '2026-05-01 12:00', '[)'));
  3. 競合する行をスキップします: ON CONFLICT DO NOTHING、排他制約でも動作します(DO UPDATE そうではありません)。

    INSERT INTO bookings (room_id, during)
    VALUES (4, tstzrange('2026-05-01 10:00', '2026-05-01 11:00'))
    ON CONFLICT ON CONSTRAINT bookings_room_during_excl DO NOTHING;

安全に再現する

その btree_gist 拡張機能により、GiSTインデックスでプレーンな整数を次と比較できます =.

CREATE EXTENSION IF NOT EXISTS btree_gist;
CREATE TEMP TABLE b (room int, during tstzrange,
    EXCLUDE USING gist (room WITH =, during WITH &&));
INSERT INTO b VALUES (1, tstzrange('2026-01-01 10:00', '2026-01-01 11:00'));
INSERT INTO b VALUES (1, tstzrange('2026-01-01 10:30', '2026-01-01 12:00'));  -- ERROR: conflicting key value violates exclusion constraint

関連エラー

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

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

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

SQLly で PostgreSQL を操作する

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