...
Eroare Python · Baze de date cu sqlite3

sqlite3.ProgrammingError: Error binding parameter 1: type 'list' is not supported

Pe scurt

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ă

Greșit
PYTHON
import sqlite3
conn = sqlite3.connect(":memory:")
conn.execute("CREATE TABLE articole (titlu TEXT, etichete TEXT)")
conn.execute("INSERT INTO articole VALUES (?, ?)", ("Python", ["cod", "baze"]))
Corect
PYTHON
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ă

Greșit
PYTHON
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],))
Corect
PYTHON
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

Greșit
PYTHON
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,))
Corect
PYTHON
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ă tu

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.

Codul care dă eroarea
PYTHON
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)
După reparație, programul afișează
cafea 18.5
zahar 6.0
Indiciu

Un ? ține o singură valoare; ai nevoie de câte unul pentru fiecare id.

Alte forme ale mesajului

  • sqlite3.ProgrammingError: Error binding parameter 1: type 'dict' is not supported
  • sqlite3.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ă TEXT sau, 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

← Toate erorile Python

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