ERROR: subquery must return only one column
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ă
SELECT nume, (SELECT max(data), sum(total) FROM comenzi WHERE client_id = c.id) FROM clienti c;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
SELECT * FROM clienti WHERE id IN (SELECT client_id, total FROM comenzi);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ă 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.
SELECT c.nume,
(SELECT max(data), sum(total) FROM comenzi WHERE client_id = c.id) AS rezumat
FROM clienti c
ORDER BY c.id;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
Reparația
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
ORDER BY c.id;De ce merge
O subinterogare scalară poate da o singură valoare. Cu LEFT JOIN LATERAL, subinterogarea rulează pentru fiecare client și întoarce două coloane, ultima și suma, folosite apoi ca orice alte coloane. LEFT și ON true păstrează clienta Elena Dinu, care nu are comenzi, cu valori NULL.
Alte forme ale mesajului
ERROR: subquery has too many columns
Cum o eviți pe viitor
- Folosește
LATERALcâ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
JOINcu 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
ERROR: more than one row returned by a subquery used as an expression O subinterogare folosită ca valoare (în SELECT, în WHERE cu =, într-un SET) a întors mai multe rânduri, deși trebuia să întoarcă cel mult unul. Fie restrânge-o (max, LIMIT 1 cu ORDER BY, o condiție mai precisă), fie folosește IN, EXISTS sau un JOIN dacă ai nevoie de toate rândurile. ERROR: each UNION query must have the same number of columns Ramurile unui UNION (sau INTERSECT, EXCEPT) au un număr diferit de coloane. Fiecare ramură trebuie să dea exact aceleași coloane, ca număr și ordine. Adaugă coloana care lipsește (de exemplu o constantă 'produs' sau NULL) sau scoate coloana în plus. ERROR: column "c.nume" must appear in the GROUP BY clause or be used in an aggregate function Interogarea are GROUP BY, iar în SELECT apare o coloană care nu e grupată și nici într-o funcție agregată. Pentru fiecare grup ar exista mai multe valori posibile, iar PostgreSQL nu alege una la întâmplare. Adaugă coloana în GROUP BY, pune-o într-un agregat sau grupează după cheia primară a tabelului ei. Î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.
