...
Eroare PostgreSQL · Constrângeri, chei și secvențe

ERROR: conflicting key value violates exclusion constraint "rezervari_perioada_excl"

Pe scurt

Rândul nou se suprapune cu unul existent conform unei constrângeri EXCLUDE, de exemplu o rezervare a aceleiași săli într-un interval care se intersectează cu altul. DETAIL arată cele două rânduri în conflict. Alege un interval liber sau tratează conflictul în aplicație.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Constrângerile de excludere generalizează unicitatea: în loc de „nu pot exista două rânduri egale”, spun „nu pot exista două rânduri pentru care toți operatorii dați sunt adevărați”. Exemplul clasic: EXCLUDE USING gist (sala WITH =, perioada WITH &&) interzice două rezervări ale aceleiași săli cu perioade care se suprapun. Pentru egalitatea pe coloane obișnuite în GiST este nevoie de extensia btree_gist.

Mesajul vine cu DETAIL: Key (sala, perioada)=(...) conflicts with existing key (sala, perioada)=(...), deci vezi exact rezervarea cu care te-ai suprapus. Atenție la limitele intervalelor: tstzrange(a, b) este implicit [a, b), inclusiv la început și exclusiv la final, deci o rezervare 10–11 și una 11–12 nu se suprapun. Cu '[]' ar intra în conflict.

De ce apare: cauzele frecvente

1Rezervare suprapusă

Greșit
SQL
INSERT INTO rezervari VALUES ('A', tstzrange('2025-03-14 10:00', '2025-03-14 12:00'));  -- există 11–12
Corect
SQL
INSERT INTO rezervari VALUES ('A', tstzrange('2025-03-14 12:00', '2025-03-14 13:00'));

Intervalul nou începe exact când se termină cel existent, deci nu se suprapune.

2Limite incluse la ambele capete

Greșit
SQL
tstzrange('2025-03-14 10:00', '2025-03-14 11:00', '[]')
Corect
SQL
tstzrange('2025-03-14 10:00', '2025-03-14 11:00')  -- implicit [)

Cu limita de final exclusă, rezervările consecutive sunt permise.

Repară tu

Repară eroarea, direct în pagină

Sala A e rezervată între 11:00 și 12:00 pe 14 martie 2025. Rezervarea nouă 10:00–12:00 dă conflicting key value violates exclusion constraint. Mut-o în intervalul liber 12:00–13:00 și afișează sala și perioada rezervărilor, ordonate cronologic.

Codul care dă eroarea
SQL
INSERT INTO rezervari VALUES ('A', tstzrange('2025-03-14 10:00+02', '2025-03-14 12:00+02'));
SELECT sala, perioada FROM rezervari ORDER BY lower(perioada);
După reparație, programul afișează
INSERT 0 1
 sala |                      perioada
------+-----------------------------------------------------
 A    | ["2025-03-14 11:00:00+02","2025-03-14 12:00:00+02")
 A    | ["2025-03-14 12:00:00+02","2025-03-14 13:00:00+02")
(2 rânduri)
Indiciu

Intervalele [11:00, 12:00) și [12:00, 13:00) nu se suprapun.

Cum o eviți pe viitor

  • Folosește intervale semi-deschise [) pentru perioade de timp; sunt standardul pentru rezervări.
  • Tratează codul SQLSTATE 23P01 în aplicație și propune intervale libere.
  • Creează constrângerea în baza de date, nu doar verificarea în aplicație: altfel două cereri simultane pot trece amândouă.
  • Instalează btree_gist când combini egalitatea pe coloane simple cu operatori de interval.

Întrebări frecvente

De ce nu ajunge o verificare SELECT înainte de INSERT?

Două tranzacții simultane pot verifica amândouă că intervalul e liber și pot insera amândouă. Constrângerea e verificată atomic de baza de date.

Ce face operatorul &&?

Pe intervale (range), întoarce true dacă cele două intervale au cel puțin un punct comun.

Erori înrudite

← Toate erorile PostgreSQL

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață PostgreSQL de la zero, cu exerciții la fiecare lecție

Curs PostgreSQL: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.