subqueries prohibited in partial index WHERE clauses
Condiția WHERE a unui index parțial conține o subinterogare (IN (SELECT ...), EXISTS). Un index parțial poate folosi doar coloanele tabelului și constante. Pune în condiție o valoare fixă sau o coloană a rândului, nu date din alt tabel.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un index parțial (CREATE INDEX ... WHERE condiție) conține doar rândurile care îndeplinesc condiția, de exemplu doar comenzile active. E mai mic și mai rapid decât un index complet. Pentru asta, SQLite trebuie să poată decide la fiecare INSERT, UPDATE sau DELETE dacă rândul intră în index, uitându-se doar la rândul respectiv.
O subinterogare citește alte tabele (sau alte rânduri), care se pot schimba fără ca rândul să se schimbe, iar indexul ar deveni greșit. De aceea SQLite refuză orice SELECT în condiția indexului parțial. Aceeași regulă e și pentru parametri (?) și funcții nedeterministe.
Soluția e să exprimi condiția prin coloane ale rândului: de exemplu în loc de client_id IN (SELECT id FROM clienti WHERE activ = 1) ții un indicator în chiar tabelul indexat sau folosești un index complet.
De ce apare: cauzele frecvente
1Condiție pe alt tabel
CREATE INDEX ix_comenzi_vip ON comenzi (data)
WHERE client_id IN (SELECT id FROM clienti WHERE vip = 1);CREATE INDEX ix_comenzi_vip ON comenzi (data)
WHERE prioritate = 'vip';Condiția folosește o coloană a comenzii, deci SQLite poate decide singur pentru fiecare rând.
2Prag calculat dintr-o subinterogare
CREATE INDEX ix_scumpe ON produse (pret)
WHERE pret > (SELECT AVG(pret) FROM produse);CREATE INDEX ix_scumpe ON produse (pret)
WHERE pret > 500;Media se schimbă cu fiecare produs nou, deci nu poate fi condiția unui index. Folosește un prag fix sau un index complet pe pret.
Repară eroarea, direct în pagină
Vrei un index parțial doar pe comenzile clienților VIP. Indexul folosește o subinterogare pe clienti și dă subqueries prohibited in partial index WHERE clauses. Comenzile au deja coloana prioritate. Repară indexul ca să folosească această coloană, apoi afișează id și data pentru comenzile VIP, ordonat după dată.
CREATE INDEX ix_comenzi_vip ON comenzi (data)
WHERE client_id IN (SELECT id FROM clienti WHERE vip = 1);
SELECT id, data FROM comenzi WHERE prioritate = 'vip' ORDER BY data;id | data 12 | 2026-03-02 10 | 2026-03-04
Indiciu
Condiția indexului poate folosi doar coloanele din comenzi.
Reparația
CREATE INDEX ix_comenzi_vip ON comenzi (data)
WHERE prioritate = 'vip';
SELECT id, data FROM comenzi WHERE prioritate = 'vip' ORDER BY data;De ce merge
Indexul parțial trebuie să poată decide, doar din rândul comenzii, dacă rândul intră în index. Subinterogarea pe clienti depinde de alt tabel, care se poate schimba oricând, așa că SQLite o refuză. Cu WHERE prioritate = 'vip', condiția folosește o coloană a comenzii, iar interogarea cu aceeași condiție poate folosi indexul.
Comenzile VIP: 12 (2 martie) și 10 (4 martie).
Alte forme ale mesajului
parameters prohibited in partial index WHERE clausesnon-deterministic functions prohibited in partial index WHERE clausesERROR: cannot use subquery in index predicate
Cum o eviți pe viitor
Folosește indecși parțiali pentru condiții simple pe rând, care se schimbă rar: WHERE status = 'activa', WHERE sters = 0, WHERE email IS NOT NULL. Ca SQLite să folosească indexul, interogarea trebuie să conțină aceeași condiție. Pentru filtre care depind de alte tabele, un index complet pe coloana de legătură e alegerea corectă.
Întrebări frecvente
Când folosește SQLite un index parțial?
Doar dacă din WHERE-ul interogării se poate deduce condiția indexului. Pentru indexul WHERE status = 'activa', interogarea trebuie să conțină status = 'activa'.
Pot face UNIQUE parțial?
Da: CREATE UNIQUE INDEX ... ON clienti(email) WHERE sters = 0 cere emailuri unice doar printre clienții neșterși. Și acolo condiția nu poate avea subinterogări.
Erori înrudite
subqueries prohibited in CHECK constraints Un CHECK verifică doar valorile din rândul curent, așa că nu poate conține SELECT. Dacă voiai „valoarea trebuie să existe în alt tabel”, folosește o cheie străină (REFERENCES). Pentru reguli mai complicate, un trigger. non-deterministic functions prohibited in generated columns Expresia unei coloane generate sau a unui index folosește o funcție care dă alt rezultat la fiecare apel (random(), CURRENT_TIMESTAMP). Valoarea trebuie să depindă doar de rând. Pentru data creării folosește o coloană obișnuită cu DEFAULT CURRENT_TIMESTAMP. parameters are not allowed in views În CREATE VIEW ai folosit un parametru (?, :prag, @prag). Un view e o interogare salvată fără valori legate, deci nu poate avea parametri. Scoate condiția din view și pune-o în SELECT-ul care folosește view-ul: SELECT * FROM v WHERE pret > ?. Î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.
