...
Eroare SQL · Coloane generate, indecși și RETURNING

subqueries prohibited in partial index WHERE clauses

Pe scurt

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

Greșit
SQL
CREATE INDEX ix_comenzi_vip ON comenzi (data)
WHERE client_id IN (SELECT id FROM clienti WHERE vip = 1);
Corect
SQL
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

Greșit
SQL
CREATE INDEX ix_scumpe ON produse (pret)
WHERE pret > (SELECT AVG(pret) FROM produse);
Corect
SQL
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ă tu

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

Codul care dă eroarea
SQL
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;
După reparație, programul afișează
id | data
12 | 2026-03-02
10 | 2026-03-04
Indiciu

Condiția indexului poate folosi doar coloanele din comenzi.

Alte forme ale mesajului

  • parameters prohibited in partial index WHERE clauses
  • non-deterministic functions prohibited in partial index WHERE clauses
  • ERROR: 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

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