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"].
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Cu sqlite3, valorile se trimit separat de SQL, prin parametri: fiecare ? din interogare primește un element din al doilea argument al lui execute. Mesajul compară cele două numere: The current statement uses 1 (un ?) and there are 3 supplied (trei valori primite).
Cazul clasic: cur.execute("SELECT * FROM clienti WHERE nume = ?", ("Ana")). Parantezele singure nu fac un tuplu, deci ("Ana") e textul "Ana", iar sqlite3 îl parcurge literă cu literă: trei valori pentru un singur ?. Reparația e virgula: ("Ana",).
Alte cauze: ai adăugat o coloană în INSERT fără să adaugi și ?-ul ei, sau trimiți un dicționar cu prea multe sau prea puține valori. Dacă trimiți un singur număr fără tuplu, mesajul diferă: parameters are of unsupported type.
De ce apare: cauzele frecvente
1Lipsește virgula din tuplu
import sqlite3
con = sqlite3.connect(":memory:")
con.execute("CREATE TABLE clienti (nume TEXT)")
con.execute("INSERT INTO clienti VALUES (?)", ("Ana"))import sqlite3
con = sqlite3.connect(":memory:")
con.execute("CREATE TABLE clienti (nume TEXT)")
con.execute("INSERT INTO clienti VALUES (?)", ("Ana",))
print(con.execute("SELECT nume FROM clienti").fetchall())("Ana",) e un tuplu cu un element; fără virgulă, fiecare literă era trimisă ca valoare separată.
2Coloană nouă fără ? corespunzător
import sqlite3
con = sqlite3.connect(":memory:")
con.execute("CREATE TABLE produse (nume TEXT, pret REAL, stoc INT)")
con.execute("INSERT INTO produse (nume, pret) VALUES (?, ?)", ("pix", 5.0, 40))import sqlite3
con = sqlite3.connect(":memory:")
con.execute("CREATE TABLE produse (nume TEXT, pret REAL, stoc INT)")
con.execute("INSERT INTO produse (nume, pret, stoc) VALUES (?, ?, ?)", ("pix", 5.0, 40))
print(con.execute("SELECT * FROM produse").fetchone())Câte valori trimiți, atâtea ? trebuie să existe în interogare.
3Un singur număr fără tuplu
import sqlite3
con = sqlite3.connect(":memory:")
con.execute("CREATE TABLE p (id INT)")
con.execute("SELECT * FROM p WHERE id = ?", 7)import sqlite3
con = sqlite3.connect(":memory:")
con.execute("CREATE TABLE p (id INT)")
print(con.execute("SELECT * FROM p WHERE id = ?", (7,)).fetchall())Parametrii sunt mereu o secvență (tuplu, listă) sau un dicționar; aici mesajul e parameters are of unsupported type.
Repară eroarea, direct în pagină
Funcția comenzi_client caută comenzile unui client într-o bază SQLite, dar apelul dă sqlite3.ProgrammingError: Incorrect number of bindings supplied. The current statement uses 1, and there are 3 supplied.. Repar-o ca programul să afișeze [(1, 120.0), (3, 45.5)].
import sqlite3
con = sqlite3.connect(":memory:")
con.execute("CREATE TABLE comenzi (id INT, client TEXT, total REAL)")
con.executemany("INSERT INTO comenzi VALUES (?, ?, ?)",
[(1, "Ana", 120.0), (2, "Dan", 80.0), (3, "Ana", 45.5)])
def comenzi_client(nume):
cur = con.execute("SELECT id, total FROM comenzi WHERE client = ? ORDER BY id", (nume))
return cur.fetchall()
print(comenzi_client("Ana"))[(1, 120.0), (3, 45.5)]
Indiciu
Al doilea argument al lui execute trebuie să fie un tuplu cu un element, iar un tuplu cu un element are nevoie de virgulă.
Reparația
import sqlite3
con = sqlite3.connect(":memory:")
con.execute("CREATE TABLE comenzi (id INT, client TEXT, total REAL)")
con.executemany("INSERT INTO comenzi VALUES (?, ?, ?)",
[(1, "Ana", 120.0), (2, "Dan", 80.0), (3, "Ana", 45.5)])
def comenzi_client(nume):
cur = con.execute("SELECT id, total FROM comenzi WHERE client = ? ORDER BY id", (nume,))
return cur.fetchall()
print(comenzi_client("Ana"))De ce merge
(nume) e doar textul "Ana" între paranteze, iar sqlite3 l-a parcurs ca pe o secvență de trei litere, adică trei valori pentru un singur ?. Cu (nume,), al doilea argument e un tuplu cu un element, care completează exact semnul ?. Interogarea întoarce apoi comenzile 1 și 3 ale Anei.
Alte forme ale mesajului
sqlite3.ProgrammingError: Incorrect number of bindings supplied. The current statement uses 2, and there are 1 supplied.sqlite3.ProgrammingError: Incorrect number of bindings supplied. The current statement uses 3, and there are 2 supplied.sqlite3.ProgrammingError: parameters are of unsupported typesqlite3.ProgrammingError: You did not supply a value for binding parameter :email.
Cum o eviți pe viitor
- Când ai un singur parametru, scrie
(valoare,)sau[valoare]; virgula e ușor de uitat, lista nu. - Folosește parametri cu nume pentru interogări lungi:
VALUES (:nume, :pret)cu un dicționar{"nume": ..., "pret": ...}. - Când adaugi o coloană într-un
INSERT, adaugă în același timp și?-ul ei. - Nu construi niciodată SQL cu f-string-uri din date: parametrii te protejează de SQL injection.
Întrebări frecvente
De ce nu pun valorile direct în SQL cu un f-string?
Pentru că un text cu ghilimele (O'Brien) ar strica interogarea, iar date venite de la utilizatori ar putea modifica SQL-ul (SQL injection). Cu ?, valorile sunt trimise separat și tratate mereu ca date.
Merge la fel în MySQL sau PostgreSQL?
Ideea e aceeași, dar semnul diferă: bibliotecile psycopg și mysql-connector folosesc %s în loc de ?. Și acolo un singur parametru trebuie trimis ca tuplu cu virgulă.
Erori înrudite
TypeError: not all arguments converted during string formatting Ai folosit operatorul `%` pe un text și i-ai dat mai multe valori decât locuri `%s`/`%d` sunt în text, sau ai aplicat `%` pe un text crezând că e număr (de exemplu `"10" % 2`). Potrivește numărul de valori cu locurile din text sau convertește textul în număr. ValueError: too many values to unpack (expected 2) În stânga lui `=` ai mai puține variabile decât valori în dreapta, de exemplu `a, b = [1, 2, 3]`. Cel mai des apare la `for cheie, valoare in dictionar` (fără `.items()`) sau la `split()` care dă mai multe bucăți. Potrivește numărul de variabile cu numărul de valori. TypeError: cannot unpack non-iterable NoneType object Despachetezi (`a, b = functie()`) un rezultat care e `None`. Funcția nu are `return` pe drumul parcurs sau returnează doar pe unele ramuri. Asigură-te că întoarce mereu un tuplu, de exemplu `return minim, maxim`. Î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.
