...
Eroare SQL · Sintaxă din MySQL, PostgreSQL și SQL Server

near "MERGE": syntax error

Pe scurt

SQLite nu are comanda MERGE din SQL Server, Oracle și PostgreSQL 15+. Același efect (actualizează rândurile existente, inserează rândurile noi) se obține cu UPSERT: INSERT ... ON CONFLICT (cheie) DO UPDATE SET ...

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

MERGE INTO tinta USING sursa ON (condiție) WHEN MATCHED THEN UPDATE ... WHEN NOT MATCHED THEN INSERT ... e comanda standard pentru sincronizarea a două tabele. SQLite nu o are: parserul nu recunoaște primul cuvânt și se oprește imediat, cu near "MERGE": syntax error.

Echivalentul SQLite e UPSERT: un INSERT obișnuit urmat de ON CONFLICT (coloana_unica) DO UPDATE SET .... Rândurile al căror id (sau altă coloană UNIQUE) există deja sunt actualizate, celelalte sunt inserate. În DO UPDATE, excluded.coloana e valoarea din rândul nou.

Două diferențe de reținut: UPSERT are nevoie de o constrângere PRIMARY KEY sau UNIQUE pe coloana din ON CONFLICT, iar ramura WHEN NOT MATCHED BY SOURCE THEN DELETE din MERGE se face separat, cu un DELETE.

De ce apare: cauzele frecvente

1MERGE din SQL Server sau Oracle

Greșit
SQL
MERGE INTO produse p
USING import_produse i ON p.id = i.id
WHEN MATCHED THEN UPDATE SET pret = i.pret
WHEN NOT MATCHED THEN INSERT (id, nume, pret)
  VALUES (i.id, i.nume, i.pret);
Corect
SQL
INSERT INTO produse (id, nume, pret)
SELECT id, nume, pret FROM import_produse WHERE true
ON CONFLICT (id) DO UPDATE SET pret = excluded.pret;

UPSERT face cele două ramuri dintr-o comandă. WHERE true e necesar după FROM, ca ON CONFLICT să nu fie citit ca JOIN.

2Ștergerea rândurilor care nu mai sunt în sursă

Greșit
SQL
MERGE INTO produse p USING import_produse i ON p.id = i.id
WHEN NOT MATCHED BY SOURCE THEN DELETE;
Corect
SQL
DELETE FROM produse
WHERE id NOT IN (SELECT id FROM import_produse);

Partea de ștergere devine un DELETE separat, cu o subinterogare.

Repară tu

Repară eroarea, direct în pagină

Scriptul din SQL Server sincronizează produse cu import_produse: actualizează prețul produselor existente și adaugă produsele noi. În SQLite dă near "MERGE": syntax error. Rescrie-l cu UPSERT și afișează id, nume, pret din produse, ordonate după id.

Codul care dă eroarea
SQL
MERGE INTO produse p
USING import_produse i ON p.id = i.id
WHEN MATCHED THEN UPDATE SET pret = i.pret
WHEN NOT MATCHED THEN INSERT (id, nume, pret) VALUES (i.id, i.nume, i.pret);
SELECT id, nume, pret FROM produse ORDER BY id;
După reparație, programul afișează
id | nume | pret
1 | Mouse wireless | 99
2 | Hub USB-C | 149
3 | Cablu HDMI | 39
4 | Webcam HD | 189
Indiciu

INSERT ... SELECT, apoi ON CONFLICT pe cheia primară; nu uita problema lui ON după FROM.

Alte forme ale mesajului

  • ERROR: syntax error at or near "MERGE"
  • ERROR 1064 (42000): You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near 'MERGE INTO produse p' at line 1

Cum o eviți pe viitor

Când lucrezi pe SQLite, ține minte UPSERT-ul ca formă standard de „inserează sau actualizează”: INSERT ... ON CONFLICT (cheie) DO UPDATE SET col = excluded.col. Asigură-te că, coloana din ON CONFLICT are PRIMARY KEY sau UNIQUE. MySQL are propria formă, ON DUPLICATE KEY UPDATE, iar PostgreSQL are atât ON CONFLICT cât și MERGE (din versiunea 15).

Întrebări frecvente

Pot actualiza doar dacă valoarea s-a schimbat?

Da, cu WHERE în DO UPDATE: DO UPDATE SET pret = excluded.pret WHERE pret <> excluded.pret.

INSERT OR REPLACE nu face același lucru?

Nu chiar: INSERT OR REPLACE șterge rândul vechi și inserează unul nou, deci coloanele nemenționate devin implicite și cheile străine cu ON DELETE reacționează. UPSERT actualizează rândul existent.

Erori înrudite

← Toate erorile SQL

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ță SQL de la zero, cu exerciții la fiecare lecție

Curs SQL: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.