...
Eroare SQL · Erori de sintaxă

variable number must be between ?1 and ?32766

Pe scurt

Ai scris un parametru numerotat invalid, de obicei ?0: în SQLite numerotarea parametrilor începe de la ?1, iar numărul maxim e ?32766. Folosește ?1, ?2... sau simplu ?, iar în editor înlocuiește parametrii cu valori concrete.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

În SQLite, un parametru (placeholder) poate fi scris ?, ?NNN, :nume, @nume sau $nume. Forma ?NNN înseamnă „parametrul cu numărul NNN” și numărul trebuie să fie între 1 și limita setată la compilare, aici 32766.

Mesajul apare când SQLite găsește ?0 (cineva a numărat de la zero, ca la indicii din Python sau Java) sau un număr prea mare, de exemplu ?40000, produs de un cod care generează interogarea automat. Interogarea nici nu se pregătește, deci eroarea apare înainte să fie legată vreo valoare.

În editorul nostru nu există legare de parametri: un ? simplu ar primi NULL. Ca să testezi o interogare scrisă pentru aplicație, înlocuiește parametrii cu valori reale.

De ce apare: cauzele frecvente

1Parametri numerotați de la zero

Greșit
SQL
SELECT nume FROM produse
WHERE pret > ?0 AND stoc > ?1;
Corect
SQL
SELECT nume FROM produse
WHERE pret > ?1 AND stoc > ?2;

Primul parametru e ?1, nu ?0. În aplicație, valorile se leagă în aceeași ordine: prima valoare la ?1, a doua la ?2.

2Număr de parametru generat greșit

Greșit
SQL
-- generat de cod: ?40000
SELECT nume FROM produse WHERE id = ?40000;
Corect
SQL
SELECT nume FROM produse WHERE id = ?;

Numărul după ? e poziția parametrului, nu valoarea lui. Un ? simplu e cea mai sigură variantă.

3Placeholder lăsat în interogarea testată manual

Greșit
SQL
SELECT nume FROM produse WHERE pret > ?0;
Corect
SQL
SELECT nume FROM produse WHERE pret > 100;

Când rulezi interogarea direct, fără aplicație, nimeni nu leagă parametrii. Pune valori concrete ca să vezi rezultatul.

Repară tu

Repară eroarea, direct în pagină

Interogarea a fost copiată din aplicație și are parametri numerotați de la zero. Repar-o ca să afișeze nume și pret pentru produsele mai scumpe de 100 de lei și cu stocul peste 5, ordonate după preț. Înlocuiește parametrii cu valorile 100 și 5.

Codul care dă eroarea
SQL
SELECT nume, pret
FROM produse
WHERE pret > ?0 AND stoc > ?1
ORDER BY pret;
După reparație, programul afișează
nume | pret
Tastatură mecanică | 349
Indiciu

În editor nu se leagă parametri: pune direct valorile în locul lui ?0 și ?1.

Alte forme ale mesajului

  • sqlite3.OperationalError: variable number must be between ?1 and ?32766
  • variable number must be between ?1 and ?999

Cum o eviți pe viitor

Folosește ? simplu sau parametri cu nume (:pret_min), care nu se pot număra greșit. Dacă ai nevoie de ?NNN (de exemplu ca să refolosești aceeași valoare de două ori), numără de la 1. Când testezi manual o interogare din aplicație, copiaz-o și înlocuiește parametrii cu valori reale, nu cu numere de poziție.

Întrebări frecvente

De ce limita e 32766 și nu 999?

Limita se stabilește la compilarea SQLite. Versiunile mai vechi aveau 999, versiunile recente au 32766. Mesajul îți spune exact limita versiunii pe care o folosești.

E același lucru cu „too many SQL variables”?

Nu chiar. „too many SQL variables” apare când ai prea mulți parametri într-o interogare (de exemplu un IN cu zeci de mii de valori). Aici problema e numărul scris după ?.

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.