ERROR: set-returning functions are not allowed in WHERE
Ai folosit în WHERE o funcție care întoarce mai multe rânduri (unnest, generate_series, jsonb_array_elements, regexp_matches). O condiție are nevoie de o singură valoare pe rând. Pentru căutarea într-un array, folosește = ANY(array) sau @>; pentru elementele unui JSON, @> sau EXISTS cu funcția în FROM.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Funcțiile care întorc mulțimi (set-returning functions, SRF) produc zero, unul sau mai multe rânduri pentru fiecare apel. În lista SELECT sau în FROM acest lucru are sens: rândurile se multiplică. În WHERE, JOIN ... ON, CASE sau într-un agregat, o condiție trebuie să aibă o singură valoare, deci PostgreSQL refuză.
Pentru array-uri, condiția „conține elementul” se scrie 'gaming' = ANY(etichete) sau etichete @> ARRAY['gaming'] (al doilea poate folosi un index GIN). Pentru JSONB: doc @> '{"tag": "gaming"}' sau doc->'etichete' ? 'gaming'. Pentru condiții mai complexe, pune funcția în FROM într-o subinterogare EXISTS (SELECT 1 FROM unnest(etichete) e WHERE e LIKE 'gam%').
De ce apare: cauzele frecvente
1Căutare într-un array cu unnest
SELECT nume FROM articole WHERE unnest(etichete) = 'gaming';SELECT nume FROM articole WHERE 'gaming' = ANY(etichete);= ANY verifică dacă vreun element e egal cu valoarea, într-o singură condiție.
2Condiție pe elementele unui array JSON
SELECT id FROM comenzi_json WHERE jsonb_array_elements(doc->'linii')->>'sku' = 'MS-01';SELECT id FROM comenzi_json WHERE doc->'linii' @> '[{"sku": "MS-01"}]';@> caută un obiect cu acel sku în array, fără să desfacă rândurile.
3Condiție cu tipar
SELECT nume FROM articole WHERE unnest(etichete) LIKE 'gam%';SELECT nume FROM articole a
WHERE EXISTS (SELECT 1 FROM unnest(a.etichete) e WHERE e LIKE 'gam%');Funcția trece în FROM-ul unei subinterogări.
Repară eroarea, direct în pagină
Tabelul articole are o coloană etichete text[]. Căutarea articolelor cu eticheta „gaming” dă set-returning functions are not allowed in WHERE. Rescrie condiția cu = ANY și afișează numele articolelor găsite, ordonate.
SELECT nume
FROM articole
WHERE unnest(etichete) = 'gaming'
ORDER BY nume;nume ---------------- Laptop Nova Mouse Wireless (2 rânduri)
Indiciu
'gaming' = ANY(etichete)
Reparația
SELECT nume
FROM articole
WHERE 'gaming' = ANY(etichete)
ORDER BY nume;De ce merge
unnest întoarce câte un rând pentru fiecare etichetă, iar WHERE are nevoie de o singură valoare pe rând. 'gaming' = ANY(etichete) verifică dacă vreun element al array-ului este egal cu „gaming” și dă un singur rezultat boolean. Sunt găsite laptopul și mouse-ul, care au această etichetă.
Cum o eviți pe viitor
- Pentru array-uri, folosește
= ANY(...),@>și&&; pentru JSONB,@>,?și jsonpath. - Pune funcțiile care întorc mai multe rânduri în
FROM(eventualLATERAL), nu în condiții. - Creează indecși GIN pe coloanele array sau JSONB în care cauți des.
Întrebări frecvente
Ce face && la array-uri?
Verifică dacă două array-uri au cel puțin un element comun: etichete && ARRAY['gaming', 'office'].
Pot folosi unnest în SELECT?
Da: SELECT nume, unnest(etichete) dă câte un rând pentru fiecare etichetă. Varianta în FROM cu LATERAL e totuși mai explicită.
Erori înrudite
ERROR: aggregate functions are not allowed in WHERE Ai pus o funcție agregată (sum, count, avg, max) în WHERE. WHERE filtrează rânduri individuale înainte de grupare, când agregatele încă nu există. Condițiile pe agregate se scriu în HAVING, după GROUP BY: HAVING sum(total) > 1000. ERROR: window functions are not allowed in WHERE Ai folosit o funcție fereastră (row_number, rank, lag) în WHERE. Funcțiile fereastră se calculează după WHERE, GROUP BY și HAVING, deci nu pot filtra direct. Calculează-le într-o subinterogare sau CTE, apoi filtrează rezultatul în interogarea exterioară. ERROR: malformed array literal: "gaming,office" Textul convertit într-un array nu are formatul PostgreSQL pentru array-uri: lipsesc acoladele ({gaming,office}), sau e JSON ([...]), sau e o listă separată prin virgule. Scrie literalul cu acolade, folosește constructorul ARRAY['a','b'] sau transformă textul cu string_to_array. Învață PostgreSQL de la zero, cu exerciții la fiecare lecție
Curs PostgreSQL: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.
