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

ERROR: structure of query does not match function result type

Pe scurt

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

Greșit
SQL
RETURNS TABLE (nume text, nr int) ... RETURN QUERY SELECT c.nume, count(*) ...
Corect
SQL
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

Greșit
SQL
RETURNS TABLE (nume text) ... SELECT nume FROM categorii;  -- varchar(40)
Corect
SQL
RETURNS TABLE (nume text) ... SELECT nume::text FROM categorii;

Conversia explicită aliniază tipul.

3Număr diferit de coloane

Greșit
SQL
RETURNS TABLE (nume text, total numeric) ... SELECT c.nume, sum(co.total), count(*) ...
Corect
SQL
RETURNS TABLE (nume text, total numeric) ... SELECT c.nume, sum(co.total) ...

Interogarea întoarce exact coloanele declarate.

Repară tu

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.

Codul care dă eroarea
SQL
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;
După reparație, programul afișează
CREATE FUNCTION
     nume      | nr
---------------+----
 Ana Pop       |  2
 Elena Dinu    |  0
 Mihai Ionescu |  1
(3 rânduri)
Indiciu

count(co.id)::int

Cum o eviți pe viitor

  • Declară în RETURNS TABLE tipurile reale ale expresiilor (bigint pentru count, numeric pentru sume).
  • Folosește conversii explicite în RETURN QUERY câ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

← 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.