ERROR: conflicting key value violates exclusion constraint "rezervari_perioada_excl"
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ă
INSERT INTO rezervari VALUES ('A', tstzrange('2025-03-14 10:00', '2025-03-14 12:00')); -- există 11–12INSERT 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
tstzrange('2025-03-14 10:00', '2025-03-14 11:00', '[]')tstzrange('2025-03-14 10:00', '2025-03-14 11:00') -- implicit [)Cu limita de final exclusă, rezervările consecutive sunt permise.
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.
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);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.
Reparația
INSERT INTO rezervari VALUES ('A', tstzrange('2025-03-14 12:00+02', '2025-03-14 13:00+02'));
SELECT sala, perioada FROM rezervari ORDER BY lower(perioada);De ce merge
Tabelul ține rezervările unei singure săli, iar constrângerea EXCLUDE USING gist (perioada WITH &&) interzice ca două rezervări să aibă perioade care se suprapun. Intervalul 10–12 se intersecta cu 11–12. Noul interval începe la 12:00, iar pentru că limitele sunt [), rezervarea existentă se termină exact înainte de ora 12, deci nu există niciun punct comun.
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_gistcâ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
ERROR: duplicate key value violates unique constraint "produse_pkey" Încerci să inserezi sau să actualizezi un rând cu o valoare care există deja într-o coloană cu cheie primară sau UNIQUE. Linia DETAIL arată cheia duplicată. Un caz frecvent: secvența unei coloane identity/serial a rămas în urmă după inserări cu id-uri explicite, iar următorul id generat există deja. ERROR: new row for relation "produse" violates check constraint "produse_pret_check" Rândul nou sau modificat nu respectă o constrângere CHECK, de exemplu un preț zero sau negativ când regula cere pret > 0. DETAIL arată rândul complet. Corectează valoarea; dacă regula s-a schimbat, modifică constrângerea, nu o ocoli. ERROR: there is no unique or exclusion constraint matching the ON CONFLICT specification Coloanele din ON CONFLICT (coloana) nu au o constrângere UNIQUE, cheie primară sau index unic exact pe ele. PostgreSQL are nevoie de o asemenea constrângere ca să detecteze conflictul. Creează constrângerea sau indexul unic, ori folosește în ON CONFLICT coloanele care au deja unul. Î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.
