...
Eroare PostgreSQL · Funcții, proceduri și triggere PL/pgSQL

ERROR: cannot use RETURN QUERY in a non-SETOF function

Pe scurt

RETURN QUERY adaugă rânduri la rezultatul unei funcții care întoarce un set (RETURNS SETOF sau RETURNS TABLE). Funcția ta întoarce o singură valoare. Schimbă declarația în RETURNS TABLE (...) sau SETOF, ori folosește SELECT ... INTO și RETURN pentru o valoare.

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

Ce înseamnă

În PL/pgSQL există două feluri de funcții după rezultat. Cele scalare (RETURNS integer, RETURNS text, RETURNS comenzi) întorc o singură valoare cu RETURN expresie. Cele care întorc mulțimi (RETURNS SETOF tip, RETURNS TABLE (...)) construiesc rezultatul cu RETURN NEXT și RETURN QUERY, apoi se termină cu RETURN; simplu. Combinația greșită dă erori la crearea funcției: aceasta pentru RETURN QUERY într-o funcție scalară, iar RETURN cannot have a parameter in function returning set pentru RETURN valoare într-o funcție de mulțimi.

Alege după felul în care va fi folosită funcția: dacă apare în FROM (SELECT * FROM f()) și întoarce rânduri, e de mulțimi; dacă apare ca valoare într-o expresie, e scalară. Funcțiile RETURNS TABLE sunt cea mai clară formă pentru rapoarte.

De ce apare: cauzele frecvente

1Funcție declarată scalară, folosită pentru rânduri

Greșit
SQL
CREATE FUNCTION comenzi_client(p int) RETURNS comenzi ... RETURN QUERY SELECT * FROM comenzi WHERE client_id = p;
Corect
SQL
CREATE FUNCTION comenzi_client(p int) RETURNS SETOF comenzi ... RETURN QUERY SELECT * FROM comenzi WHERE client_id = p;

SETOF permite oricâte rânduri.

2Valoare unică scrisă cu RETURN QUERY

Greșit
SQL
RETURNS numeric ... RETURN QUERY SELECT sum(total) FROM comenzi;
Corect
SQL
RETURNS numeric ... RETURN (SELECT sum(total) FROM comenzi);

Pentru o valoare, RETURN primește o expresie.

Repară tu

Repară eroarea, direct în pagină

Funcția comenzi_client trebuie să întoarcă toate comenzile unui client, dar e declarată RETURNS comenzi (un singur rând) și dă cannot use RETURN QUERY in a non-SETOF function. Declar-o RETURNS SETOF comenzi și afișează id-ul și totalul comenzilor clientului 1.

Codul care dă eroarea
SQL
CREATE FUNCTION comenzi_client(p_id int) RETURNS comenzi LANGUAGE plpgsql AS $$
BEGIN
  RETURN QUERY SELECT * FROM comenzi WHERE client_id = p_id;
END $$;
SELECT id, total FROM comenzi_client(1) ORDER BY id;
După reparație, programul afișează
CREATE FUNCTION
 id |  total
----+---------
  1 | 3559.40
  2 |  289.00
(2 rânduri)
Indiciu

RETURNS SETOF comenzi

Alte forme ale mesajului

  • ERROR: RETURN cannot have a parameter in function returning set

Cum o eviți pe viitor

  • Decide de la început dacă funcția întoarce o valoare sau un set de rânduri.
  • Folosește RETURNS TABLE (...) pentru funcții care întorc rapoarte.
  • Apelează funcțiile de mulțimi în FROM: SELECT * FROM f().
  • Pentru logică simplă, o funcție LANGUAGE sql cu RETURNS TABLE evită complet PL/pgSQL.

Întrebări frecvente

Ce face RETURN NEXT?

Adaugă un singur rând la rezultatul unei funcții SETOF, de obicei într-o buclă.

Funcția SETOF se oprește la RETURN QUERY?

Nu. Adaugă rândurile și continuă; funcția se termină la RETURN; sau la END.

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.