...
Eroare SQL · Erori de sintaxă

near "%": syntax error (placeholder %s din Python)

Pe scurt

Î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

Greșit
SQL
SELECT nume FROM clienti
WHERE oras = %s;
Corect
SQL
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

Greșit
SQL
cur.execute(
  "SELECT nume FROM clienti WHERE oras = %s",
  ("Iași",)
)
Corect
SQL
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

Greșit
SQL
SELECT nume FROM produse
WHERE nume LIKE %led%;
Corect
SQL
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ă tu

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

Codul care dă eroarea
SQL
SELECT nume
FROM clienti
WHERE oras = %s
ORDER BY nume;
După reparație, programul afișează
nume
Ana Vasile
Ioana Dinu
Indiciu

În editor nu există niciun program care să înlocuiască placeholder-ul cu o valoare.

Alte forme ale mesajului

  • sqlite3.OperationalError: near "%": syntax error
  • ERROR: 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

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