sqlite3.ProgrammingError: Error binding parameter 1: type 'list' is not supported
Ai trimis ca parametru SQL o valoare pe care SQLite nu o poate stoca direct: o listă, un dicționar, un obiect. SQLite primește doar None, int, float, str și bytes. Transformă valoarea (json.dumps, ", ".join) sau, pentru WHERE ... IN, pune câte un ? pentru fiecare element.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Parametrii unei interogări (?) sunt înlocuiți cu valori pe care SQLite le înțelege: NULL, întreg, real, text și blob. În Python, asta înseamnă None, int, float, str și bytes (plus bool, salvat ca 0/1). Orice alt tip trebuie transformat de tine.
Error binding parameter 1 îți spune care parametru e problema: numărătoarea începe de la 1, în ordinea semnelor ?. type 'list' is not supported îți spune tipul valorii. În versiunile mai vechi de Python, mesajul era Error binding parameter 0 - probably unsupported type (numărătoare de la 0) și era de tipul InterfaceError.
Cauzele obișnuite: vrei să salvezi o listă de etichete într-o coloană, trimiți un dicționar întreg în loc de un câmp, sau scrii WHERE id IN (?) cu o listă. Un singur ? înseamnă o singură valoare, nu o listă.
De ce apare: cauzele frecvente
1Listă salvată direct într-o coloană
import sqlite3
conn = sqlite3.connect(":memory:")
conn.execute("CREATE TABLE articole (titlu TEXT, etichete TEXT)")
conn.execute("INSERT INTO articole VALUES (?, ?)", ("Python", ["cod", "baze"]))import sqlite3, json
conn = sqlite3.connect(":memory:")
conn.execute("CREATE TABLE articole (titlu TEXT, etichete TEXT)")
conn.execute("INSERT INTO articole VALUES (?, ?)", ("Python", json.dumps(["cod", "baze"])))
print(json.loads(conn.execute("SELECT etichete FROM articole").fetchone()[0]))json.dumps transformă lista într-un text, iar la citire json.loads o reface.
2WHERE ... IN (?) cu o listă
import sqlite3
conn = sqlite3.connect(":memory:")
conn.execute("CREATE TABLE produse (id INTEGER, nume TEXT)")
conn.execute("SELECT nume FROM produse WHERE id IN (?)", ([1, 2, 3],))import sqlite3
conn = sqlite3.connect(":memory:")
conn.execute("CREATE TABLE produse (id INTEGER, nume TEXT)")
ids = [1, 2, 3]
semne = ", ".join("?" * len(ids))
print(conn.execute(f"SELECT nume FROM produse WHERE id IN ({semne})", ids).fetchall())Generezi câte un ? pentru fiecare element și trimiți lista ca parametri. Textul SQL conține doar semne ?, deci rămâne sigur.
3Dicționar întreg în loc de un câmp
import sqlite3
conn = sqlite3.connect(":memory:")
conn.execute("CREATE TABLE clienti (nume TEXT)")
client = {"nume": "Ana", "oras": "Cluj"}
conn.execute("INSERT INTO clienti VALUES (?)", (client,))import sqlite3
conn = sqlite3.connect(":memory:")
conn.execute("CREATE TABLE clienti (nume TEXT)")
client = {"nume": "Ana", "oras": "Cluj"}
conn.execute("INSERT INTO clienti VALUES (?)", (client["nume"],))
print(conn.execute("SELECT * FROM clienti").fetchall())Trimite câmpul de care are nevoie coloana. Pentru dicționare există și parametrii cu nume: VALUES (:nume) cu client ca argument.
Repară eroarea, direct în pagină
Programul caută prețurile mai multor produse odată, dar interogarea dă sqlite3.ProgrammingError: Error binding parameter 1: type 'list' is not supported. Repar-o păstrând parametrii (fără să lipești id-urile în textul SQL), ca programul să afișeze cafea 18.5 și zahar 6.0.
import sqlite3
conn = sqlite3.connect(":memory:")
conn.execute("CREATE TABLE produse (id INTEGER, nume TEXT, pret REAL)")
conn.executemany("INSERT INTO produse VALUES (?, ?, ?)",
[(1, "cafea", 18.5), (2, "ceai", 9.9), (3, "zahar", 6.0)])
cautate = [1, 3]
sql = "SELECT nume, pret FROM produse WHERE id IN (?) ORDER BY id"
for nume, pret in conn.execute(sql, (cautate,)):
print(nume, pret)cafea 18.5 zahar 6.0
Indiciu
Un ? ține o singură valoare; ai nevoie de câte unul pentru fiecare id.
Reparația
import sqlite3
conn = sqlite3.connect(":memory:")
conn.execute("CREATE TABLE produse (id INTEGER, nume TEXT, pret REAL)")
conn.executemany("INSERT INTO produse VALUES (?, ?, ?)",
[(1, "cafea", 18.5), (2, "ceai", 9.9), (3, "zahar", 6.0)])
cautate = [1, 3]
semne = ", ".join("?" * len(cautate))
sql = f"SELECT nume, pret FROM produse WHERE id IN ({semne}) ORDER BY id"
for nume, pret in conn.execute(sql, cautate):
print(nume, pret)De ce merge
Un singur ? primea toată lista [1, 3], iar SQLite nu poate lega o listă de un parametru. ", ".join("?" * len(cautate)) produce ?, ?, câte un semn pentru fiecare id, iar lista e trimisă ca parametri separați. Textul SQL conține doar semne ?, deci valorile rămân separate de cod.
Alte forme ale mesajului
sqlite3.ProgrammingError: Error binding parameter 1: type 'dict' is not supportedsqlite3.InterfaceError: Error binding parameter 0 - probably unsupported type.
Cum o eviți pe viitor
- Trimite în parametri doar
None,int,float,str,bytes. - Pentru structuri (liste, dicționare), salvează-le ca JSON într-o coloană
TEXTsau, mai bine, într-un tabel separat (relația unu-la-mulți). - Pentru
IN, generează semnele?după lungimea listei. - Pentru date calendaristice, salvează-le explicit ca text ISO:
data.isoformat().
Întrebări frecvente
De ce numărul parametrului e 1, dar e al doilea element din tuplu?
Din Python 3.11 numărătoarea pornește de la 1, ca în SQLite. Al doilea ? e parametrul 2. În versiunile vechi pornea de la 0.
E o idee bună să țin liste ca JSON în SQLite?
Pentru date mici, citite întregi (setări, etichete afișate), e în regulă. Dacă vrei să cauți sau să filtrezi după elemente, un tabel separat e mai potrivit. SQLite are și funcții JSON (json_each) pentru căutări ocazionale.
Erori înrudite
sqlite3.ProgrammingError: Incorrect number of bindings supplied. The current statement uses 1, and there are 3 supplied. Numărul de valori trimise la execute() nu se potrivește cu numărul de semne ? din interogare. Cel mai des, ai scris ("Ana") în loc de ("Ana",): fără virgulă nu e tuplu, ci un text, iar fiecare literă devine o valoare. Pune virgula sau folosește o listă: ["Ana"]. TypeError: Object of type datetime is not JSON serializable `json.dumps()` știe să transforme doar dicționare, liste, texte, numere, `True`/`False` și `None`. O dată calendaristică, un `Decimal`, un `set` sau un obiect al tău trebuie convertite întâi: `d.isoformat()`, `float(x)`, `list(s)`, sau `json.dumps(date, default=str)`. sqlite3.OperationalError: no such column: nume Interogarea folosește o coloană pe care tabelul nu o are: nume scris greșit, coloană adăugată în cod dar nu și în baza existentă, sau un text pus fără ghilimele (WHERE oras = Cluj), pe care SQLite îl citește ca nume de coloană. Învață Python de la zero, cu exerciții la fiecare lecție
Curs Python: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
