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

ERROR: query returned more than one row

Pe scurt

SELECT ... INTO STRICT (sau o subinterogare din PL/pgSQL care cere un singur rând) a găsit mai multe rânduri. Restrânge interogarea: o condiție mai precisă, un agregat sau ORDER BY ... LIMIT 1, după ce rând îți trebuie.

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

Ce înseamnă

Cu INTO STRICT, PL/pgSQL cere exact un rând. Mai multe rânduri dau această eroare (excepția TOO_MANY_ROWS), cu HINT: Make sure the query returns a single row, or use LIMIT 1. Aceeași eroare apare la INSERT/UPDATE/DELETE ... RETURNING ... INTO care afectează mai multe rânduri și, în SQL obișnuit, sub forma more than one row returned by a subquery used as an expression.

Eroarea semnalează aproape mereu o presupunere greșită: „clientul are o singură comandă”, „emailul e unic” (dar nu există constrângere), „există un singur preț activ”. Soluția depinde de ce rând îți trebuie: cel mai recent (ORDER BY data DESC LIMIT 1), un agregat (sum, max) sau o condiție mai precisă. Dacă unicitatea ar trebui garantată, adaugă constrângerea în baza de date, nu doar în cod.

De ce apare: cauzele frecvente

1Ultima comandă a clientului

Greșit
SQL
SELECT total INTO STRICT v FROM comenzi WHERE client_id = p_id;
Corect
SQL
SELECT total INTO v FROM comenzi WHERE client_id = p_id ORDER BY data DESC LIMIT 1;

Se ia explicit comanda cea mai recentă.

2UPDATE ... RETURNING INTO pe mai multe rânduri

Greșit
SQL
UPDATE produse SET stoc = stoc - 1 WHERE categorie = 'Accesorii' RETURNING stoc INTO v;
Corect
SQL
UPDATE produse SET stoc = stoc - 1 WHERE id = p_id RETURNING stoc INTO v;

Condiția pe cheie primară garantează un singur rând.

Repară tu

Repară eroarea, direct în pagină

Funcția ultima_comanda întoarce totalul ultimei comenzi a unui client, dar pentru Ana Pop, care are două comenzi, dă query returned more than one row. Ia comanda cea mai recentă cu ORDER BY și LIMIT 1 și afișează rezultatul pentru clienții 1 și 2.

Codul care dă eroarea
SQL
CREATE FUNCTION ultima_comanda(p_id int) RETURNS numeric LANGUAGE plpgsql AS $$
DECLARE
  v numeric;
BEGIN
  SELECT total INTO STRICT v FROM comenzi WHERE client_id = p_id;
  RETURN v;
END $$;
SELECT ultima_comanda(1) AS c1, ultima_comanda(2) AS c2;
După reparație, programul afișează
CREATE FUNCTION
   c1   |   c2
--------+---------
 289.00 | 1299.00
(1 rând)
Indiciu

ORDER BY data DESC LIMIT 1

Cum o eviți pe viitor

  • Scrie interogările din INTO pe chei unice sau cu agregate.
  • Când alegi „un rând dintre mai multe”, folosește ORDER BY și LIMIT 1, nu doar LIMIT 1.
  • Adaugă constrângeri unice pentru regulile de tip „cel mult unul”.
  • Testează funcțiile pe date cu mai multe rânduri pe aceeași cheie.

Întrebări frecvente

Este LIMIT 1 fără ORDER BY o soluție?

Evită eroarea, dar rândul ales e arbitrar și se poate schimba între execuții.

Ce excepție prind?

EXCEPTION WHEN too_many_rows THEN ....

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.