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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
MERGE INTO tinta USING sursa ON conditie compară fiecare rând din țintă cu rândurile sursei. Standardul SQL cere ca fiecare rând din țintă să fie modificat cel mult o dată. Dacă doi corespondenți din sursă îl ating, rezultatul ar depinde de ordine, iar PostgreSQL dă această eroare, cu HINT: Ensure that not more than one source row matches any one target row.
Cauzele sunt aceleași ca la upsert: sursa are duplicate pe cheia de legătură sau condiția ON este prea largă (de exemplu compară doar categoria în loc de id). Reparația: deduplici sursa într-o subinterogare (USING (SELECT DISTINCT ON (...) ...) s) sau o agregi (USING (SELECT produs_id, sum(cantitate) ... GROUP BY produs_id) s), după regula de business. MERGE e util pentru sincronizări complexe (inserare, actualizare și ștergere în aceeași instrucțiune).
De ce apare: cauzele frecvente
1Sursă cu mișcări multiple pe produs
MERGE INTO stoc t USING miscari s ON t.produs_id = s.produs_id
WHEN MATCHED THEN UPDATE SET cantitate = t.cantitate + s.delta;MERGE INTO stoc t
USING (SELECT produs_id, sum(delta) AS delta FROM miscari GROUP BY produs_id) s
ON t.produs_id = s.produs_id
WHEN MATCHED THEN UPDATE SET cantitate = t.cantitate + s.delta;Agregarea sursei dă un singur rând pe produs.
2Condiție ON prea largă
MERGE INTO produse t USING reduceri s ON t.categorie = s.categorie ... -- două reduceri pe categorieMERGE INTO produse t USING (SELECT DISTINCT ON (categorie) * FROM reduceri ORDER BY categorie, procent DESC) s
ON t.categorie = s.categorie ...Se păstrează o singură reducere pe categorie.
Repară eroarea, direct în pagină
Tabelul miscari are două mișcări pentru produsul 1 (+3 și -1). MERGE-ul care aplică mișcările pe stoc dă MERGE command cannot affect row a second time. Agregă mișcările pe produs în sursă și afișează stocul final, ordonat după produs.
MERGE INTO stoc t
USING miscari s ON t.produs_id = s.produs_id
WHEN MATCHED THEN UPDATE SET cantitate = t.cantitate + s.delta;
SELECT * FROM stoc ORDER BY produs_id;MERGE 2
produs_id | cantitate
-----------+-----------
1 | 7
2 | 35
(2 rânduri)Indiciu
USING (SELECT produs_id, sum(delta) AS delta FROM miscari GROUP BY produs_id) s
Reparația
MERGE INTO stoc t
USING (SELECT produs_id, sum(delta) AS delta FROM miscari GROUP BY produs_id) s
ON t.produs_id = s.produs_id
WHEN MATCHED THEN UPDATE SET cantitate = t.cantitate + s.delta;
SELECT * FROM stoc ORDER BY produs_id;De ce merge
Ambele mișcări ale produsului 1 se potriveau cu același rând din stoc. Agregând sursa cu sum(delta) pe produs, fiecare rând țintă are un singur corespondent: produsul 1 primește +2 și ajunge la 7, iar produsul 2 primește -5 și ajunge la 35. Regula „suma mișcărilor” este explicită în interogare.
Cum o eviți pe viitor
- Verifică unicitatea cheii de legătură în sursă înainte de
MERGE. - Agregă sau deduplică sursa într-o subinterogare, după o regulă explicită.
- Pentru inserări concurente, preferă
INSERT ... ON CONFLICT, care e sigur la apeluri simultane. - Folosește
RETURNING merge_action(), *(PostgreSQL 17+) ca să vezi ce a făcut fiecare rând.
Întrebări frecvente
MERGE e sigur la execuții simultane?
Nu complet: două sesiuni pot decide amândouă că rândul nu există și pot insera. Pentru upsert concurent, ON CONFLICT e mai sigur.
Ce face WHEN NOT MATCHED BY SOURCE?
Din PostgreSQL 17, tratează rândurile din țintă care nu au corespondent în sursă, de exemplu pentru ștergere la sincronizare.
Erori înrudite
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: more than one row returned by a subquery used as an expression O subinterogare folosită ca valoare (în SELECT, în WHERE cu =, într-un SET) a întors mai multe rânduri, deși trebuia să întoarcă cel mult unul. Fie restrânge-o (max, LIMIT 1 cu ORDER BY, o condiție mai precisă), fie folosește IN, EXISTS sau un JOIN dacă ai nevoie de toate rândurile. 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.
