PostgreSQL 23P01: Verletzung der Ausschlusseinschränkung
Eine Zeile steht im Konflikt mit einer vorhandenen Zeile unter einer EXCLUDE-Bedingung, typischerweise ein überlappender Zeitraum für denselben Raum, dieselbe Ressource oder Person.
- SQLSTATE
23P01- Name
exclusion_violation- Kategorie
- Integritätsbedingungsverletzung
Was es bedeutet
Eine Ausschlussbedingung verallgemeinert die Eindeutigkeit: Keine zwei Zeilen dürfen gleichzeitig alle aufgelisteten Vergleiche erfüllen. Die klassische Verwendung ist EXCLUDE USING gist (room_id WITH =, during WITH &&), was bedeutet, dass keine zwei Buchungen für denselben Raum überlappende Zeiträume haben dürfen.
23P01 bedeutet, dass die neue oder aktualisierte Zeile mit der vorhandenen Zeile kollidiert, die in der DETAIL Zeile sieht.
Häufige Ursachen
- Eine Doppelbuchung: der neue Zeitraum überlappt einen bestehenden für denselben Schlüssel.
- Bereiche mit einschließenden oberen Grenzen (
[a,b]) die daran beteiligt sind:[10:00,11:00]und[11:00,12:00]Überlappung um 11:00. Die standardmäßige halb-offene Form[a,b)vermeidet dies. - Zwei gleichzeitige Transaktionen fügen sich überlappende Bereiche ein; die zweite schlägt fehl, wenn die erste committet.
Wie du es behebst
-
Finde die kollidierenden Zeilen, bevor du schreibst, oder zeig dem Nutzer, welche Buchung im Weg ist.
SELECT * FROM bookings WHERE room_id = 4 AND during && tstzrange('2026-05-01 10:00', '2026-05-01 11:00'); -
Verwende halboffene Bereiche, damit sich aufeinanderfolgende Buchungen nicht überlappen.
INSERT INTO bookings (room_id, during) VALUES (4, tstzrange('2026-05-01 11:00', '2026-05-01 12:00', '[)')); -
Zeilen mit Konflikten überspringen mit
ON CONFLICT DO NOTHING, das mit Exclusion-Constraints funktioniert (DO UPDATEnicht).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;
Sicher reproduzieren
das btree_gist -Erweiterung ermöglicht einem GiST-Index den Vergleich einfacher Ganzzahlen mit =.
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
Zugehörige Fehler
23505Doppelter Schlüssel verletzt Unique-Constraint23514Check-Bedingung verletzt42P10ungültige Spaltenreferenz
Weitere Fehler bei der Verletzung von Integritätsbedingungen
Der Code und der Meldungstext stammen aus der PostgreSQL-Dokumentation, Anhang A: PostgreSQL-Fehlercodes. Durchstöbere die vollständige PostgreSQL-Fehlerliste oder Jeden Datenbankfehler durchsuchen.
Arbeiten mit PostgreSQL in SQLly
Ein nativer SQL-Client für macOS, Windows und Linux mit schemabewusstem IntelliSense, Guardrails für riskante Anweisungen und klaren Fehlermeldungen, für PostgreSQL und die anderen Datenbanken, mit denen du arbeitest.