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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
UPSERT-ul din SQLite (ON CONFLICT (...) DO UPDATE SET ...) merge direct după VALUES (...). Când datele vin dintr-un SELECT ... FROM tabel, apare o ambiguitate: după numele tabelului din FROM, cuvântul ON poate fi începutul unui JOIN ... ON condiție. Parserul alege varianta cu JOIN, citește CONFLICT(id) ca pe o condiție și se blochează la DO, de unde near "DO": syntax error.
E o limitare cunoscută, descrisă chiar în documentația SQLite. Soluția oficială: pune o clauză WHERE după FROM, de obicei WHERE true, ca ON-ul de după ea să nu mai poată fi citit ca parte din JOIN.
Același lucru se întâmplă cu ON CONFLICT DO NOTHING după un SELECT cu FROM.
De ce apare: cauzele frecvente
1UPSERT după INSERT ... SELECT
INSERT INTO produse (id, nume, pret)
SELECT id, nume, pret FROM import_produse
ON CONFLICT (id) DO UPDATE SET pret = excluded.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;WHERE true închide partea de FROM, deci ON e citit ca început de ON CONFLICT. Condiția e mereu adevărată, nu filtrează nimic.
2DO NOTHING după SELECT
INSERT INTO clienti (email)
SELECT email FROM import_clienti
ON CONFLICT DO NOTHING;INSERT INTO clienti (email)
SELECT email FROM import_clienti WHERE true
ON CONFLICT DO NOTHING;Aceeași ambiguitate, aceeași soluție. Alternativ, INSERT OR IGNORE INTO ... face același lucru fără ON CONFLICT.
Repară eroarea, direct în pagină
Importăm prețurile noi din import_produse în produse: produsele existente își actualizează prețul, cele noi se adaugă. Interogarea dă near "DO": syntax error. Repar-o fără să schimbi logica UPSERT-ului.
INSERT INTO produse (id, nume, pret)
SELECT id, nume, pret FROM import_produse
ON CONFLICT (id) DO UPDATE SET pret = excluded.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
Indiciu
Parserul crede că ON aparține lui FROM; închide partea de FROM cu o clauză care nu filtrează nimic.
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
Fără WHERE, ON de după FROM import_produse putea fi începutul unei condiții de JOIN, iar SQLite l-a citit așa. WHERE true închide partea de FROM și nu elimină niciun rând.
Acum UPSERT-ul merge: Hub USB-C (id 2) existent primește prețul 149, iar Cablu HDMI (id 3) e adăugat.
Alte forme ale mesajului
sqlite3.OperationalError: near "DO": syntax error
Cum o eviți pe viitor
Când scrii UPSERT peste un INSERT ... SELECT, pune din reflex un WHERE după FROM: fie o condiție reală (WHERE pret IS NOT NULL), fie WHERE true. Testează UPSERT-ul cu un rând care există deja și unul nou, ca să vezi ambele ramuri. Pentru cazul simplu „sari peste duplicate”, INSERT OR IGNORE e mai scurt.
Întrebări frecvente
De ce cu VALUES merge?
După VALUES (...) nu poate urma un JOIN, deci ON nu e ambiguu.
Ce e excluded?
Un tabel special din UPSERT care conține rândul pe care ai încercat să-l inserezi. excluded.pret e prețul nou, pret singur e prețul vechi din tabel.
Erori înrudite
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ă. UNIQUE constraint failed: produse.id Inserezi un rând cu un id care există deja în tabel. Cheia primară e unică. Nu da id-ul la INSERT (lasă SQLite să-l genereze pentru INTEGER PRIMARY KEY) sau folosește un id liber; dacă vrei să înlocuiești rândul, folosește UPDATE sau ON CONFLICT. 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. Î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.
