...
Eroare PostgreSQL · GROUP BY, subinterogări, UNION și ferestre

ERROR: set-returning functions are not allowed in WHERE

Pe scurt

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

Greșit
SQL
SELECT nume FROM articole WHERE unnest(etichete) = 'gaming';
Corect
SQL
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

Greșit
SQL
SELECT id FROM comenzi_json WHERE jsonb_array_elements(doc->'linii')->>'sku' = 'MS-01';
Corect
SQL
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

Greșit
SQL
SELECT nume FROM articole WHERE unnest(etichete) LIKE 'gam%';
Corect
SQL
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ă tu

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.

Codul care dă eroarea
SQL
SELECT nume
FROM articole
WHERE unnest(etichete) = 'gaming'
ORDER BY nume;
După reparație, programul afișează
      nume
----------------
 Laptop Nova
 Mouse Wireless
(2 rânduri)
Indiciu

'gaming' = ANY(etichete)

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 (eventual LATERAL), 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

← Toate erorile PostgreSQL

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