PostgreSQL 23P01: нарушение ограничения исключения
Строка конфликтует с существующей строкой по ограничению EXCLUDE, обычно это перекрывающийся диапазон времени для одной и той же комнаты, ресурса или человека.
- SQLSTATE
23P01- Имя
exclusion_violation- Категория
- Нарушение ограничения целостности
Что это значит
Исключающее ограничение обобщает уникальность: никакие две строки не могут одновременно удовлетворять всем перечисленным сравнениям. Классическое применение — EXCLUDE USING gist (room_id WITH =, during WITH &&), то есть две брони одной и той же комнаты не могут иметь пересекающихся диапазонов.
23P01 означает, что новая или обновленная строка конфликтует с существующей строкой, показанной в DETAIL строку.
Распространённые причины
- Двойное бронирование: новый диапазон перекрывается с существующим для того же ключа.
- Диапазоны с включающими верхними границами (
[a,b]), которые затрагивают:[10:00,11:00]и[11:00,12:00]перекрываются в 11:00. Используемая по умолчанию полуоткрытая форма[a,b)избегает этого. - Две одновременные транзакции вставляют пересекающиеся диапазоны; вторая завершается ошибкой, когда первая фиксирует изменения.
Как исправить
-
Найдите конфликтующие строки перед записью или покажите пользователю, какая бронь мешает.
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
Связанные ошибки
23505повторяющийся ключ нарушает ограничение уникальности23514нарушение ограничения CHECK42P10недопустимая ссылка на столбец
Больше ошибок нарушения ограничений целостности
Код и текст сообщения взяты из Документация PostgreSQL, приложение A: коды ошибок PostgreSQL. Смотрите весь Список ошибок PostgreSQL или поиск по всем ошибкам баз данных.
Работа с PostgreSQL в SQLly
Нативный SQL-клиент для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и понятными сообщениями об ошибках — для PostgreSQL и других баз данных, которые вы используете.