near "%": syntax error (placeholder %s din Python)
În SQL a ajuns un placeholder de tip %s sau %(nume)s, copiat din codul Python pentru psycopg2 sau MySQL. SQLite nu-l înțelege. În editor pune valoarea direct ('Iași'), iar în cod folosește placeholder-ul SQLite: ? sau :nume.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Semnul % nu are niciun sens în sintaxa SQLite în afara unui text între apostrofuri (LIKE '%led%'). Când parserul îl găsește liber în interogare, se oprește acolo și spune near "%": syntax error.
Aproape mereu e un placeholder dintr-un program: bibliotecile psycopg2 (PostgreSQL) și mysql-connector (MySQL) folosesc %s și %(nume)s, iar biblioteca înlocuiește placeholder-ul cu valoarea înainte de trimitere. Modulul sqlite3 din Python și majoritatea driverelor SQLite folosesc în schimb ? sau :nume. Dacă lipești interogarea din cod direct în editor, sau o trimiți cu alt driver decât cel pentru care a fost scrisă, %s ajunge neschimbat la SQLite.
Mai apare când cineva scrie % în afara apostrofurilor la LIKE: LIKE %led%.
De ce apare: cauzele frecvente
1Interogare copiată din cod, cu %s
SELECT nume FROM clienti
WHERE oras = %s;SELECT nume FROM clienti
WHERE oras = 'Iași';În editor nu există un program care să înlocuiască %s. Pune valoarea propriu-zisă, ca text între apostrofuri.
2Placeholder psycopg2 folosit cu sqlite3
cur.execute(
"SELECT nume FROM clienti WHERE oras = %s",
("Iași",)
)cur.execute(
"SELECT nume FROM clienti WHERE oras = ?",
("Iași",)
)Modulul sqlite3 recunoaște doar ? și :nume. Placeholder-ul %s e trimis ca atare și dă eroare de sintaxă.
3LIKE fără apostrofuri
SELECT nume FROM produse
WHERE nume LIKE %led%;SELECT nume FROM produse
WHERE nume LIKE '%led%';Tiparul lui LIKE e un text, deci are nevoie de apostrofuri. Fără ele, % e un caracter străin pentru parser.
Repară eroarea, direct în pagină
Interogarea de mai jos a fost copiată dintr-un program Python și dă near "%": syntax error. Repar-o ca să afișeze numele clienților din Iași, în ordine alfabetică.
SELECT nume
FROM clienti
WHERE oras = %s
ORDER BY nume;nume Ana Vasile Ioana Dinu
Indiciu
În editor nu există niciun program care să înlocuiască placeholder-ul cu o valoare.
Reparația
SELECT nume
FROM clienti
WHERE oras = 'Iași'
ORDER BY nume;De ce merge
%s e placeholder-ul folosit de psycopg2 și mysql-connector, înlocuit de bibliotecă înainte ca interogarea să ajungă la baza de date. Aici ajunge neschimbat la SQLite, care nu-l recunoaște.
Cu valoarea scrisă direct, 'Iași', interogarea e completă și întoarce Ana Vasile și Ioana Dinu. Într-un program pe SQLite ai fi scris WHERE oras = ? și ai fi trimis ('Iași',) separat.
Alte forme ale mesajului
sqlite3.OperationalError: near "%": syntax errorERROR: syntax error at or near "%"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 '%s' at line 2
Cum o eviți pe viitor
Ține minte placeholder-ul fiecărui driver: ? sau :nume la SQLite (sqlite3 în Python, better-sqlite3 în Node), %s la psycopg2 și mysql-connector, $1 la pg din Node. Când testezi în editor o interogare din cod, înlocuiește întâi fiecare placeholder cu o valoare reală. Nu construi niciodată interogarea prin lipire de texte (f"... = '{oras}'"): placeholder-ele te apără și de SQL injection.
Întrebări frecvente
De ce merge același cod pe PostgreSQL și nu pe SQLite?
Pentru că pe PostgreSQL %s e înlocuit de psycopg2, nu de baza de date. Cu sqlite3, înlocuirea se face doar pentru ? și :nume.
Pot folosi %s cu sqlite3 dacă formatez textul cu operatorul %?
Tehnic da, dar e periculos: valoarea intră direct în SQL și deschide ușa la SQL injection. Folosește ? și trimite valorile separat.
Erori înrudite
near "'scump'": syntax error SQLite a găsit un text între apostrofuri într-un loc unde aștepta un cuvânt-cheie sau un operator. De obicei lipsește THEN într-un CASE, lipsește = înaintea textului sau e o sintaxă din alt dialect (ENUM, INTERVAL). Verifică ce cuvânt lipsește chiar înaintea textului. unrecognized token: "'București;" Un șir de text a fost deschis cu apostrof și nu a fost închis, așa că SQLite nu poate recunoaște unde se termină. Pune apostroful de închidere: 'București'. Dacă textul conține el însuși un apostrof, dublează-l: 'O''Brien'. near "DECLARE": syntax error SQLite nu are variabile în SQL: DECLARE @x și SET @x = ... sunt din SQL Server / MySQL. Pune valoarea direct în interogare, într-un CTE (WITH param AS (SELECT 100 AS prag)) sau trimite-o ca parametru din aplicație (? sau :prag). Î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.
