near "MERGE": syntax error
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
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);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ă
MERGE INTO produse p USING import_produse i ON p.id = i.id
WHEN NOT MATCHED BY SOURCE THEN DELETE;DELETE FROM produse
WHERE id NOT IN (SELECT id FROM import_produse);Partea de ștergere devine un DELETE separat, cu o subinterogare.
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.
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;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.
Reparația
INSERT INTO produse (id, nume, pret)
SELECT id, nume, pret FROM import_produse WHERE true
ON CONFLICT (id) DO UPDATE SET pret = excluded.pret;
SELECT id, nume, pret FROM produse ORDER BY id;De ce merge
SQLite nu are MERGE, dar UPSERT-ul acoperă ambele ramuri: fiecare rând din import_produse e inserat, iar când id-ul există deja, ON CONFLICT (id) DO UPDATE actualizează prețul cu valoarea nouă, excluded.pret.
Hub USB-C (id 2) ajunge la 149, Webcam HD (id 4) e adăugat. WHERE true oprește parserul să citească ON ca parte dintr-un JOIN.
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
near "DO": syntax error Ai scris INSERT ... SELECT ... FROM tabel ON CONFLICT ... DO UPDATE. SQLite citește acel ON ca pe începutul unei condiții de JOIN și se blochează la DO. Adaugă WHERE true după FROM (înainte de ON CONFLICT) și eroarea dispare. near "DUPLICATE": syntax error ON DUPLICATE KEY UPDATE e sintaxa MySQL pentru „inserează sau actualizează”. În SQLite (și PostgreSQL) se scrie ON CONFLICT (coloana_unica) DO UPDATE SET coloana = excluded.coloana, unde excluded înseamnă rândul pe care ai încercat să-l inserezi. ON CONFLICT clause does not match any PRIMARY KEY or UNIQUE constraint Coloana din ON CONFLICT(coloana) nu are o constrângere PRIMARY KEY sau UNIQUE, deci SQLite nu are ce conflict să detecteze. Pune în ON CONFLICT coloana care chiar e unică (de obicei cheia primară) sau adaugă un index UNIQUE pe coloana dorită. Î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.
