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

ERROR: MERGE command cannot affect row a second time

Pe scurt

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

Greșit
SQL
MERGE INTO stoc t USING miscari s ON t.produs_id = s.produs_id
WHEN MATCHED THEN UPDATE SET cantitate = t.cantitate + s.delta;
Corect
SQL
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ă

Greșit
SQL
MERGE INTO produse t USING reduceri s ON t.categorie = s.categorie ...  -- două reduceri pe categorie
Corect
SQL
MERGE 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ă tu

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.

Codul care dă eroarea
SQL
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;
După reparație, programul afișează
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

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

← 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.