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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Într-o funcție RETURNS TABLE (...) sau RETURNS SETOF tip, fiecare RETURN QUERY trebuie să producă exact coloanele declarate, cu exact aceleași tipuri. PostgreSQL nu face conversii implicite aici, iar DETAIL arată nepotrivirea: Returned type bigint does not match expected type integer in column 2. sau Number of returned columns (3) does not match expected column count (2).
Nepotriviri tipice: count(*) întoarce bigint, nu integer; sum pe integer întoarce bigint, pe numeric întoarce numeric; coloanele varchar(n) nu sunt text; round(...) dă numeric fără precizie. Soluția simplă e conversia în SELECT (count(*)::int, c.nume::text); cea mai robustă e să declari tipurile reale ale expresiilor (bigint pentru numărători, numeric pentru sume).
De ce apare: cauzele frecvente
1count(*) declarat integer
RETURNS TABLE (nume text, nr int) ... RETURN QUERY SELECT c.nume, count(*) ...RETURNS TABLE (nume text, nr bigint) ... RETURN QUERY SELECT c.nume, count(*) ...Tipul declarat corespunde cu tipul real al lui count.
2varchar față de text
RETURNS TABLE (nume text) ... SELECT nume FROM categorii; -- varchar(40)RETURNS TABLE (nume text) ... SELECT nume::text FROM categorii;Conversia explicită aliniază tipul.
3Număr diferit de coloane
RETURNS TABLE (nume text, total numeric) ... SELECT c.nume, sum(co.total), count(*) ...RETURNS TABLE (nume text, total numeric) ... SELECT c.nume, sum(co.total) ...Interogarea întoarce exact coloanele declarate.
Repară eroarea, direct în pagină
Funcția comenzi_pe_client întoarce numele și numărul de comenzi, declarat nr int, dar apelul dă structure of query does not match function result type, pentru că count(*) este bigint. Convertește numărătoarea la int în RETURN QUERY și afișează rezultatul funcției ordonat după nume.
CREATE FUNCTION comenzi_pe_client() RETURNS TABLE (nume text, nr int) LANGUAGE plpgsql AS $$
BEGIN
RETURN QUERY
SELECT c.nume, count(co.id)
FROM clienti c LEFT JOIN comenzi co ON co.client_id = c.id
GROUP BY c.id;
END $$;
SELECT * FROM comenzi_pe_client() ORDER BY nume;CREATE FUNCTION
nume | nr
---------------+----
Ana Pop | 2
Elena Dinu | 0
Mihai Ionescu | 1
(3 rânduri)Indiciu
count(co.id)::int
Reparația
CREATE FUNCTION comenzi_pe_client() RETURNS TABLE (nume text, nr int) LANGUAGE plpgsql AS $$
BEGIN
RETURN QUERY
SELECT c.nume, count(co.id)::int
FROM clienti c LEFT JOIN comenzi co ON co.client_id = c.id
GROUP BY c.id;
END $$;
SELECT * FROM comenzi_pe_client() ORDER BY nume;De ce merge
count întoarce bigint, iar funcția declară nr int, deci tipurile coloanei a doua nu se potrivesc. Conversia ::int aliniază rezultatul cu declarația. Funcția întoarce câte un rând pentru fiecare client, inclusiv Elena Dinu cu 0 comenzi, datorită lui LEFT JOIN și count(co.id).
Cum o eviți pe viitor
- Declară în
RETURNS TABLEtipurile reale ale expresiilor (bigintpentrucount,numericpentru sume). - Folosește conversii explicite în
RETURN QUERYcând tipurile coloanelor diferă. - Verifică tipul unei expresii cu
pg_typeof()înainte de a scrie declarația. - Testează funcția imediat după creare: eroarea apare doar la execuție.
Întrebări frecvente
De ce nu convertește PostgreSQL automat bigint în int?
Conversia poate pierde valori, iar PL/pgSQL cere potrivire exactă pentru rezultatele funcțiilor.
Pot schimba tipurile din RETURNS TABLE cu OR REPLACE?
Nu; tipul întors face parte din semnătură. Trebuie DROP FUNCTION și CREATE FUNCTION.
Erori înrudite
ERROR: cannot change return type of existing function CREATE OR REPLACE FUNCTION nu poate schimba tipul întors de o funcție existentă (de exemplu din integer în numeric sau din RETURNS TABLE cu alte coloane). Șterge funcția cu DROP FUNCTION (cu tipurile parametrilor) și creeaz-o din nou. 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. ERROR: column reference "id" is ambiguous Interogarea folosește o coloană (de obicei id) care există în mai multe tabele din FROM sau JOIN, iar PostgreSQL nu știe pe care o vrei. Prefixează coloana cu numele sau aliasul tabelului: c.id, co.id. În PL/pgSQL, același mesaj apare când o coloană are același nume ca o variabilă. Î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.
