// PostgreSQL エラーリファレンス
PostgreSQL 23P01: 除外制約違反
EXCLUDE 制約により、行が既存の行と競合しています。通常は、同じ部屋、リソース、または人物の時間範囲が重複しています。
- SQLSTATE
23P01- 名前
exclusion_violation- カテゴリ
- 整合性制約違反
意味
排他制約は一意性を一般化したものです。リストされたすべての比較を同時に満たす 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 つ目が失敗します。
修正方法
-
書き込む前に競合する行を探すか、どの予約が邪魔になっているかをユーザーに示します。
SELECT * FROM bookings WHERE room_id = 4 AND during && tstzrange('2026-05-01 10:00', '2026-05-01 11:00'); -
連続した予約が重複しないよう、半開区間を使用します。
INSERT INTO bookings (room_id, during) VALUES (4, tstzrange('2026-05-01 11:00', '2026-05-01 12:00', '[)')); -
競合する行をスキップします:
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 をはじめ、お使いの他のデータベースにも対応します。