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

ERROR: WITH query "sterse" does not have a RETURNING clause

Pe scurt

Ai pus un DELETE, UPDATE sau INSERT într-un CTE și îl folosești mai departe ca tabel, dar comanda nu are RETURNING. Fără RETURNING, CTE-ul nu produce rânduri. Adaugă RETURNING * (sau coloanele necesare) la comanda din WITH.

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

Ce înseamnă

PostgreSQL permite comenzi de modificare în WITH: WITH sterse AS (DELETE ... RETURNING *) INSERT INTO arhiva SELECT * FROM sterse mută rânduri dintr-un tabel în altul într-o singură instrucțiune atomică. CTE-ul produce rânduri doar prin RETURNING; fără această clauză, comanda se execută, dar nu are ce oferi interogării principale, iar referirea la el dă această eroare.

Câteva detalii utile: toate părțile unei astfel de instrucțiuni văd aceeași imagine a datelor, deci interogarea principală nu vede efectele CTE-ului în tabelul modificat, ci doar rândurile din RETURNING. Comenzile de modificare din WITH se execută o singură dată și complet, chiar dacă interogarea principală nu le citește. Aceasta e calea idiomatică pentru arhivări, mutări și jurnale de modificări.

De ce apare: cauzele frecvente

1Mutare în arhivă fără RETURNING

Greșit
SQL
WITH sterse AS (DELETE FROM comenzi WHERE data < '2025-03-05')
INSERT INTO comenzi_arhiva SELECT * FROM sterse;
Corect
SQL
WITH sterse AS (DELETE FROM comenzi WHERE data < '2025-03-05' RETURNING *)
INSERT INTO comenzi_arhiva SELECT * FROM sterse;

RETURNING * trimite rândurile șterse interogării principale.

2Jurnal de modificări

Greșit
SQL
WITH m AS (UPDATE produse SET pret = pret * 1.1 WHERE categorie = 'Accesorii')
INSERT INTO jurnal SELECT id, now() FROM m;
Corect
SQL
WITH m AS (UPDATE produse SET pret = pret * 1.1 WHERE categorie = 'Accesorii' RETURNING id)
INSERT INTO jurnal SELECT id, now() FROM m;

Doar coloanele din RETURNING sunt disponibile mai departe.

Repară tu

Repară eroarea, direct în pagină

Scriptul de arhivare mută comenzile anterioare datei de 5 martie 2025 în comenzi_arhiva, dar dă WITH query "sterse" does not have a RETURNING clause. Repar-o, apoi afișează câte comenzi au rămas și câte sunt în arhivă.

Codul care dă eroarea
SQL
WITH sterse AS (
  DELETE FROM comenzi WHERE data < '2025-03-05'
)
INSERT INTO comenzi_arhiva SELECT * FROM sterse;
SELECT (SELECT count(*) FROM comenzi) AS ramase, (SELECT count(*) FROM comenzi_arhiva) AS arhivate;
După reparație, programul afișează
INSERT 0 1
 ramase | arhivate
--------+----------
      2 |        1
(1 rând)
Indiciu

DELETE ... RETURNING *

Cum o eviți pe viitor

  • Adaugă RETURNING la orice comandă de modificare din WITH pe care o folosești ulterior.
  • Întoarce doar coloanele de care ai nevoie, cu aliasuri clare.
  • Nu te baza pe faptul că interogarea principală vede schimbările CTE-ului în tabel; folosește rândurile din RETURNING.
  • Testează mutările pe o copie a datelor sau într-o tranzacție pe care o anulezi.

Întrebări frecvente

Este operația atomică?

Da: ștergerea și inserarea fac parte din aceeași instrucțiune; dacă inserarea eșuează, nici ștergerea nu rămâne.

Pot folosi RETURNING cu coloane calculate?

Da: RETURNING id, pret * 1.19 AS pret_tva.

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.