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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
INSERT ... ON CONFLICT (cols) DO ... se bazează pe un index unic care detectează conflictul. Lista de coloane (conflict target) trebuie să corespundă exact unui index unic sau unei constrângeri: aceleași coloane, în orice ordine, iar pentru indecși parțiali aceeași condiție WHERE. Dacă nu există, PostgreSQL nu poate ști ce înseamnă „conflict” și dă această eroare.
Cauze tipice: coloana are doar un index obișnuit, nu unic; unicitatea e pe (client_id, produs_id), iar ON CONFLICT folosește doar client_id; un index unic pe o expresie (lower(email)), iar ON CONFLICT (email) nu o repetă. Soluția este să adaugi constrângerea care exprimă regula reală (ALTER TABLE ... ADD UNIQUE (...)) sau să scrii exact expresia indexului: ON CONFLICT (lower(email)).
De ce apare: cauzele frecvente
1Coloana nu are constrângere unică
INSERT INTO stoc_zilnic VALUES ('2025-03-14', 1, 5)
ON CONFLICT (zi, produs_id) DO UPDATE SET cantitate = EXCLUDED.cantitate;ALTER TABLE stoc_zilnic ADD UNIQUE (zi, produs_id);
INSERT INTO stoc_zilnic VALUES ('2025-03-14', 1, 5)
ON CONFLICT (zi, produs_id) DO UPDATE SET cantitate = EXCLUDED.cantitate;Constrângerea unică definește conflictul.
2Index unic pe expresie
CREATE UNIQUE INDEX ON clienti_noi (lower(email));
INSERT ... ON CONFLICT (email) DO NOTHING;INSERT ... ON CONFLICT (lower(email)) DO NOTHING;Ținta conflictului trebuie să repete expresia indexului.
3Doar o parte din coloanele cheii
ON CONFLICT (client_id) DO NOTHING -- unicitate pe (client_id, produs_id)ON CONFLICT (client_id, produs_id) DO NOTHINGColoanele trebuie să fie exact cele ale constrângerii.
Repară eroarea, direct în pagină
Tabelul stoc_zilnic păstrează câte un rând pe zi și produs. Upsert-ul care actualizează cantitatea dă there is no unique or exclusion constraint matching the ON CONFLICT specification. Adaugă constrângerea unică pe (zi, produs_id), rulează upsert-ul și afișează rândurile.
INSERT INTO stoc_zilnic VALUES ('2025-03-14', 1, 7)
ON CONFLICT (zi, produs_id) DO UPDATE SET cantitate = EXCLUDED.cantitate;
SELECT * FROM stoc_zilnic;ALTER TABLE
INSERT 0 1
zi | produs_id | cantitate
------------+-----------+-----------
2025-03-14 | 1 | 7
(1 rând)Indiciu
ALTER TABLE stoc_zilnic ADD UNIQUE (zi, produs_id)
Reparația
ALTER TABLE stoc_zilnic ADD UNIQUE (zi, produs_id);
INSERT INTO stoc_zilnic VALUES ('2025-03-14', 1, 7)
ON CONFLICT (zi, produs_id) DO UPDATE SET cantitate = EXCLUDED.cantitate;
SELECT * FROM stoc_zilnic;De ce merge
Fără o constrângere unică pe (zi, produs_id), PostgreSQL nu are cum să detecteze conflictul. După ADD UNIQUE, inserarea pentru aceeași zi și același produs intră pe ramura DO UPDATE, iar cantitatea devine 7 în loc să apară un al doilea rând. Constrângerea garantează regula și pentru inserările viitoare.
Cum o eviți pe viitor
- Definește constrângerile unice care exprimă regulile de business înainte să scrii upsert-uri.
- Folosește în
ON CONFLICTexact aceleași coloane sau expresii ca indexul unic. - Poți numi direct constrângerea:
ON CONFLICT ON CONSTRAINT stoc_zilnic_zi_produs_id_key. - Verifică indecșii existenți cu
\d tabelînainte să scrii ținta conflictului.
Întrebări frecvente
ON CONFLICT DO NOTHING fără coloane are nevoie de constrângere?
Nu: ON CONFLICT DO NOTHING fără țintă ignoră conflictul cu orice constrângere unică. DO UPDATE cere însă ținta.
MERGE e o alternativă?
Da, MERGE nu cere index unic, dar nu e sigur la inserări simultane: două sesiuni pot insera amândouă. Pentru upsert concurent, ON CONFLICT rămâne alegerea corectă.
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: ON CONFLICT DO UPDATE command cannot affect row a second time Același INSERT ... ON CONFLICT DO UPDATE conține de două ori aceeași cheie, deci ar actualiza același rând de două ori. PostgreSQL nu știe care valoare să păstreze. Elimină duplicatele din sursă înainte (DISTINCT ON sau GROUP BY), alegând explicit valoarea dorită. ERROR: MERGE command cannot affect row a second time Sursa din MERGE are mai multe rânduri care se potrivesc cu același rând din tabelul țintă, deci acesta ar fi actualizat de mai multe ori. Deduplică sursa înainte (DISTINCT ON, GROUP BY) sau fă condiția ON mai precisă, ca fiecare rând țintă să aibă cel mult un corespondent. Î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.
