...
Eroare Python · Module și fișiere

sqlite3.ProgrammingError: Incorrect number of bindings supplied. The current statement uses 1, and there are 3 supplied.

Pe scurt

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

Greșit
PYTHON
import sqlite3
con = sqlite3.connect(":memory:")
con.execute("CREATE TABLE clienti (nume TEXT)")
con.execute("INSERT INTO clienti VALUES (?)", ("Ana"))
Corect
PYTHON
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

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

Greșit
PYTHON
import sqlite3
con = sqlite3.connect(":memory:")
con.execute("CREATE TABLE p (id INT)")
con.execute("SELECT * FROM p WHERE id = ?", 7)
Corect
PYTHON
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ă tu

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)].

Codul care dă eroarea
PYTHON
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"))
După reparație, programul afișează
[(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ă.

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 type
  • sqlite3.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

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