PostgreSQL 23P01 : violation de la contrainte d'exclusion
Une ligne entre en conflit avec une ligne existante sous une contrainte EXCLUDE, généralement une plage horaire qui se chevauche pour la même salle, ressource ou personne.
- SQLSTATE
23P01- Nom
exclusion_violation- Catégorie
- Violation de contrainte d'intégrité
Ce que cela signifie
Une contrainte d'exclusion généralise l'unicité : deux lignes quelconques ne peuvent pas satisfaire en même temps toutes les comparaisons listées. L'utilisation classique est EXCLUDE USING gist (room_id WITH =, during WITH &&), ce qui signifie qu'aucune réservation pour la même salle ne peut avoir des plages qui se chevauchent.
23P01 signifie que la nouvelle ligne ou la ligne mise à jour est en conflit avec la ligne existante montrée dans le DETAIL ligne.
Causes courantes
- Double réservation : la nouvelle plage chevauche une plage existante pour la même clé.
- Plages avec bornes supérieures inclusives (
[a,b]) qui se touchent :[10:00,11:00]et[11:00,12:00]chevauchement à 11:00. La forme par défaut semi-ouverte[a,b)évite cela. - Deux transactions simultanées insérant des plages qui se chevauchent ; la seconde échoue lorsque la première est validée.
Comment le corriger
-
Trouvez les lignes en conflit avant d’écrire, ou montrez à l’utilisateur quelle réservation est en conflit.
SELECT * FROM bookings WHERE room_id = 4 AND during && tstzrange('2026-05-01 10:00', '2026-05-01 11:00'); -
Utilisez des plages semi-ouvertes afin que les réservations consécutives ne se chevauchent pas.
INSERT INTO bookings (room_id, during) VALUES (4, tstzrange('2026-05-01 11:00', '2026-05-01 12:00', '[)')); -
Ignorez les lignes en conflit avec
ON CONFLICT DO NOTHING, ce qui fonctionne avec les contraintes d’exclusion (DO UPDATEce n'est pas le cas).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;
Reproduisez-le en toute sécurité
Le btree_gist l’extension permet à un index GiST de comparer des entiers simples avec =.
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
Erreurs liées
23505une clé dupliquée viole la contrainte unique23514violation de contrainte CHECK42P10référence de colonne invalide
Plus d'erreurs de violation de contrainte d'intégrité
Le code et le texte du message sont issus de Documentation PostgreSQL, annexe A : Codes d’erreur PostgreSQL. Parcourir la liste complète Liste des erreurs PostgreSQL ou Rechercher toutes les erreurs de base de données.
Travailler sur PostgreSQL dans SQLly
Un client SQL natif pour macOS, Windows et Linux avec IntelliSense conscient du schéma, des garde-fous pour les instructions risquées et des messages d'erreur clairs, pour PostgreSQL et les autres bases de données que vous utilisez.