PostgreSQL 23P01: violação de restrição de exclusão
Uma linha entra em conflito com uma linha existente sob uma restrição EXCLUDE, normalmente um intervalo de tempo que se sobrepõe para a mesma sala, recurso ou pessoa.
- SQLSTATE
23P01- Nome
exclusion_violation- Categoria
- Violação de restrição de integridade
O que significa
Uma restrição de exclusão generaliza a unicidade: nenhum par de linhas pode satisfazer todas as comparações listadas ao mesmo tempo. O uso clássico é EXCLUDE USING gist (room_id WITH =, during WITH &&), significando que duas reservas para a mesma sala não podem ter intervalos sobrepostos.
23P01 significa que a nova linha ou a linha atualizada entra em conflito com a linha existente mostrada em DETAIL linha.
Causas comuns
- Uma reserva dupla: o novo intervalo se sobrepõe a um existente para a mesma chave.
- Intervalos com limites superiores inclusivos (
[a,b]) que se tocam:[10:00,11:00]e[11:00,12:00]sobreposição às 11:00. A forma padrão semiaberta[a,b)evita isso. - Duas transações concorrentes inserindo intervalos sobrepostos; a segunda falha quando a primeira é confirmada.
Como corrigir
-
Encontre as linhas em conflito antes de gravar, ou mostre ao usuário qual reserva está no caminho.
SELECT * FROM bookings WHERE room_id = 4 AND during && tstzrange('2026-05-01 10:00', '2026-05-01 11:00'); -
Use intervalos semiabertos para que reservas consecutivas não se sobreponham.
INSERT INTO bookings (room_id, during) VALUES (4, tstzrange('2026-05-01 11:00', '2026-05-01 12:00', '[)')); -
Ignore linhas em conflito com
ON CONFLICT DO NOTHING, que funciona com restrições de exclusão (DO UPDATEnão).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;
Reproduza com segurança
O btree_gist A extensão permite que um índice GiST compare inteiros simples com =.
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
Erros relacionados
23505chave duplicada viola a restrição única23514violação de restrição de verificação42P10referência de coluna inválida
Mais erros de violação de restrição de integridade
O código e o texto da mensagem são de documentação do PostgreSQL, Apêndice A: Códigos de erro do PostgreSQL. Veja toda a Lista de erros do PostgreSQL ou pesquise todos os erros do banco de dados.
Trabalhe com PostgreSQL no SQLly
Um cliente SQL nativo para macOS, Windows e Linux com IntelliSense que conhece o esquema, proteções para instruções arriscadas e mensagens de erro claras, para o PostgreSQL e os outros bancos de dados que você usa.