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ă.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Upsert-ul procesează toate rândurile propuse într-o singură instrucțiune. Dacă două dintre ele au aceeași cheie de conflict, primul l-ar insera sau actualiza, iar al doilea ar actualiza din nou același rând, cu rezultat dependent de ordine. PostgreSQL refuză, cu HINT: Ensure that no rows proposed for insertion within the same command have duplicate constrained values.
Situația apare la importuri în loturi: un fișier cu mai multe linii pentru același produs, un INSERT ... SELECT dintr-un tabel de staging cu duplicate, un JOIN care multiplică rândurile. Soluția este deduplicarea explicită a sursei, cu o regulă clară: ultima valoare (DISTINCT ON (cod) ... ORDER BY cod, moment DESC), suma (GROUP BY cod cu sum(cantitate)) sau maximul. Același principiu se aplică la MERGE, cu mesajul MERGE command cannot affect row a second time.
De ce apare: cauzele frecvente
1Lot cu cheie repetată
INSERT INTO stoc VALUES (1, 5), (1, 7)
ON CONFLICT (produs_id) DO UPDATE SET cantitate = EXCLUDED.cantitate;INSERT INTO stoc VALUES (1, 7)
ON CONFLICT (produs_id) DO UPDATE SET cantitate = EXCLUDED.cantitate;Fiecare cheie apare o singură dată în lot.
2Staging cu duplicate
INSERT INTO stoc SELECT produs_id, cantitate FROM import_stoc
ON CONFLICT (produs_id) DO UPDATE SET cantitate = EXCLUDED.cantitate;INSERT INTO stoc
SELECT DISTINCT ON (produs_id) produs_id, cantitate FROM import_stoc ORDER BY produs_id, moment DESC
ON CONFLICT (produs_id) DO UPDATE SET cantitate = EXCLUDED.cantitate;DISTINCT ON păstrează ultima valoare pentru fiecare produs.
Repară eroarea, direct în pagină
Tabelul import_stoc conține două citiri pentru produsul 1. Upsert-ul în stoc dă ON CONFLICT DO UPDATE command cannot affect row a second time. Păstrează doar citirea cea mai recentă pentru fiecare produs (după coloana moment) și afișează stocul final, ordonat după produs.
INSERT INTO stoc
SELECT produs_id, cantitate FROM import_stoc
ON CONFLICT (produs_id) DO UPDATE SET cantitate = EXCLUDED.cantitate;
SELECT * FROM stoc ORDER BY produs_id;INSERT 0 2
produs_id | cantitate
-----------+-----------
1 | 7
2 | 40
(2 rânduri)Indiciu
SELECT DISTINCT ON (produs_id) ... ORDER BY produs_id, moment DESC
Reparația
INSERT INTO stoc
SELECT DISTINCT ON (produs_id) produs_id, cantitate
FROM import_stoc
ORDER BY produs_id, moment DESC
ON CONFLICT (produs_id) DO UPDATE SET cantitate = EXCLUDED.cantitate;
SELECT * FROM stoc ORDER BY produs_id;De ce merge
Sursa avea două rânduri cu produs_id 1, deci upsert-ul ar fi actualizat același rând de două ori. DISTINCT ON (produs_id) cu ORDER BY produs_id, moment DESC păstrează câte o citire, cea mai nouă, pentru fiecare produs. Produsul 1 primește 7 bucăți, iar produsul 2 rămâne cu 40.
Cum o eviți pe viitor
- Deduplică sursa înaintea oricărui upsert sau
MERGEîn lot. - Decide explicit regula pentru duplicate: ultima valoare, suma sau maximul.
- Adaugă în staging o coloană de ordine (moment, număr de linie), ca „ultima valoare” să fie bine definită.
- Verifică duplicatele cu
GROUP BY cheie HAVING count(*) > 1înainte de import.
Întrebări frecvente
De ce nu ia pur și simplu ultima valoare?
Pentru că ordinea rândurilor dintr-un lot nu e garantată. PostgreSQL preferă să-ți ceară o regulă explicită.
Apare și cu DO NOTHING?
Nu. Cu DO NOTHING, al doilea rând e pur și simplu ignorat.
Erori înrudite
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. 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. 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. Î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.
