...
Eroare SQL · INSERT, UPDATE și tipuri de date

near "DO": syntax error

Pe scurt

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

Greșit
SQL
INSERT INTO produse (id, nume, pret)
SELECT id, nume, pret FROM import_produse
ON CONFLICT (id) DO UPDATE SET pret = excluded.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;

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

Greșit
SQL
INSERT INTO clienti (email)
SELECT email FROM import_clienti
ON CONFLICT DO NOTHING;
Corect
SQL
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ă tu

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.

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

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

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