ERROR: cannot use RETURN QUERY in a non-SETOF function
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
CREATE FUNCTION comenzi_client(p int) RETURNS comenzi ... RETURN QUERY SELECT * FROM comenzi WHERE client_id = p;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
RETURNS numeric ... RETURN QUERY SELECT sum(total) FROM comenzi;RETURNS numeric ... RETURN (SELECT sum(total) FROM comenzi);Pentru o valoare, RETURN primește o expresie.
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.
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;CREATE FUNCTION id | total ----+--------- 1 | 3559.40 2 | 289.00 (2 rânduri)
Indiciu
RETURNS SETOF comenzi
Reparația
CREATE FUNCTION comenzi_client(p_id int) RETURNS SETOF 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;De ce merge
RETURNS comenzi înseamnă un singur rând, iar RETURN QUERY construiește un set de rânduri. Cu RETURNS SETOF comenzi, funcția poate întoarce oricâte rânduri, iar apelul în FROM le tratează ca pe un tabel. Clientul 1 are două comenzi, 1 și 2.
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 sqlcuRETURNS TABLEevită 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
ERROR: RETURN cannot have a parameter in function returning void Funcția e declarată RETURNS void (nu întoarce nimic), dar conține RETURN valoare. Fie scoți valoarea (RETURN; simplu), fie schimbi tipul întors (RETURNS integer) dacă apelantul are nevoie de rezultat. Pentru proceduri, folosește parametri OUT sau INOUT. ERROR: structure of query does not match function result type RETURN QUERY (sau o funcție SQL cu RETURNS TABLE) întoarce coloane cu alte tipuri sau alt număr decât cele declarate. DETAIL spune coloana și tipurile. Convertește coloanele în SELECT la tipurile din RETURNS TABLE (de exemplu count(*)::int, nume::text) sau schimbă declarația. ERROR: query has no destination for result data Într-o funcție PL/pgSQL ai scris un SELECT al cărui rezultat nu e pus nicăieri. PL/pgSQL nu afișează rezultatele interogărilor. Folosește SELECT ... INTO variabila pentru a păstra valoarea, PERFORM pentru a o ignora sau RETURN QUERY pentru a o întoarce. Î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.
