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

ERROR: subquery must return only one column

Pe scurt

O subinterogare folosită ca o singură valoare are mai multe coloane în SELECT. O valoare scalară poate avea o singură coloană. Ca să aduci mai multe coloane din alt tabel, folosește un JOIN sau JOIN LATERAL ori scrie câte o subinterogare pentru fiecare coloană.

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

Ce înseamnă

O subinterogare scalară înlocuiește o singură valoare, deci trebuie să aibă exact o coloană (și cel mult un rând). Când scrii (SELECT max(data), sum(total) FROM ...) în lista unui SELECT, PostgreSQL nu are unde pune două valori și dă această eroare. Varianta înrudită subquery has too many columns apare la IN (SELECT a, b ...), unde lista din stânga are mai puține coloane decât subinterogarea.

Pentru mai multe valori calculate pe același rând exterior, construcția potrivită este LEFT JOIN LATERAL (SELECT ...) alias ON true: subinterogarea vede coloanele rândului curent și poate întoarce oricâte coloane. Alternativ, un LEFT JOIN cu o subinterogare grupată sau mai multe subinterogări scalare separate (mai puțin eficient).

De ce apare: cauzele frecvente

1Două agregate într-o subinterogare scalară

Greșit
SQL
SELECT nume, (SELECT max(data), sum(total) FROM comenzi WHERE client_id = c.id) FROM clienti c;
Corect
SQL
SELECT c.nume, s.ultima, s.suma
FROM clienti c
LEFT JOIN LATERAL (SELECT max(data) AS ultima, sum(total) AS suma
                   FROM comenzi WHERE client_id = c.id) s ON true;

LATERAL permite mai multe coloane calculate pe fiecare client.

2IN cu prea multe coloane

Greșit
SQL
SELECT * FROM clienti WHERE id IN (SELECT client_id, total FROM comenzi);
Corect
SQL
SELECT * FROM clienti WHERE id IN (SELECT client_id FROM comenzi);

Lista din IN trebuie să aibă tot atâtea coloane cât expresia din stânga.

Repară tu

Repară eroarea, direct în pagină

Raportul vrea pentru fiecare client numele, data ultimei comenzi și suma totală, dar subinterogarea cu două coloane dă subquery must return only one column. Rescrie-l cu LEFT JOIN LATERAL, păstrând și clienții fără comenzi, ordonați după id.

Codul care dă eroarea
SQL
SELECT c.nume,
       (SELECT max(data), sum(total) FROM comenzi WHERE client_id = c.id) AS rezumat
FROM clienti c
ORDER BY c.id;
După reparație, programul afișează
     nume      |   ultima   |  suma
---------------+------------+---------
 Ana Pop       | 2025-03-10 | 3848.40
 Mihai Ionescu | 2025-03-12 | 1299.00
 Elena Dinu    | NULL       |    NULL
(3 rânduri)
Indiciu

LEFT JOIN LATERAL (SELECT ... ) s ON true

Alte forme ale mesajului

  • ERROR: subquery has too many columns

Cum o eviți pe viitor

  • Folosește LATERAL când ai nevoie de mai multe valori calculate pentru fiecare rând.
  • Pentru IN, păstrează în subinterogare doar coloana comparată, sau compară perechi: (a, b) IN (SELECT x, y ...).
  • Rescrie subinterogările scalare repetate ca un singur JOIN cu o subinterogare grupată.

Întrebări frecvente

Ce face ON true după LATERAL?

Condiția de legătură e deja în subinterogare (client_id = c.id), deci JOIN-ul nu mai are nevoie de alta; LEFT păstrează clienții fără comenzi.

Pot compara două coloane deodată cu IN?

Da: WHERE (client_id, data) IN (SELECT client_id, max(data) FROM comenzi GROUP BY client_id).

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.