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

ERROR: ON CONFLICT DO UPDATE command cannot affect row a second time

Pe scurt

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ă

Greșit
SQL
INSERT INTO stoc VALUES (1, 5), (1, 7)
ON CONFLICT (produs_id) DO UPDATE SET cantitate = EXCLUDED.cantitate;
Corect
SQL
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

Greșit
SQL
INSERT INTO stoc SELECT produs_id, cantitate FROM import_stoc
ON CONFLICT (produs_id) DO UPDATE SET cantitate = EXCLUDED.cantitate;
Corect
SQL
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ă tu

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.

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

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

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