...
Eroare PostgreSQL · Tranzacții, blocări și concurență

ERROR: FOR UPDATE is not allowed with aggregate functions

Pe scurt

SELECT ... FOR UPDATE blochează rânduri concrete, dar o interogare cu agregate (sum, count) sau GROUP BY întoarce valori calculate, nu rânduri din tabel. Blochează rândurile într-o subinterogare sau într-o interogare separată, apoi calculează agregatul.

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

Ce înseamnă

FOR UPDATE (și FOR SHARE, FOR NO KEY UPDATE) ia blocaje pe rândurile din tabel care apar în rezultat. Când rezultatul e un agregat sau provine din GROUP BY, DISTINCT, UNION sau funcții fereastră, un rând de rezultat nu mai corespunde unui rând din tabel, deci PostgreSQL nu știe ce să blocheze. Mesajul numește clauza: FOR UPDATE is not allowed with GROUP BY clause, with DISTINCT clause, with UNION/INTERSECT/EXCEPT.

Tiparul corect: blochezi rândurile într-o subinterogare (SELECT sum(total) FROM (SELECT total FROM comenzi WHERE client_id = 1 FOR UPDATE) x) sau într-o comandă separată, apoi calculezi. Gândește-te și dacă blocarea e necesară: pentru o verificare urmată de o actualizare, uneori un UPDATE ... WHERE condiționat sau o constrângere rezolvă mai simplu problema concurenței.

De ce apare: cauzele frecvente

1Sumă cu blocare

Greșit
SQL
SELECT sum(total) FROM comenzi WHERE client_id = 1 FOR UPDATE;
Corect
SQL
SELECT sum(total) FROM (
  SELECT total FROM comenzi WHERE client_id = 1 FOR UPDATE
) x;

Subinterogarea blochează rândurile, iar exteriorul le adună.

2DISTINCT cu blocare

Greșit
SQL
SELECT DISTINCT client_id FROM comenzi FOR UPDATE;
Corect
SQL
SELECT client_id FROM comenzi FOR UPDATE;  -- deduplici în aplicație sau într-un pas separat

Blocarea se face pe rândurile individuale.

Repară tu

Repară eroarea, direct în pagină

Înainte să aplice o reducere de fidelitate, aplicația blochează comenzile clientului 1 și calculează totalul, dar interogarea dă FOR UPDATE is not allowed with aggregate functions. Blochează rândurile într-o subinterogare și afișează totalul, într-o tranzacție.

Codul care dă eroarea
SQL
BEGIN;
SELECT sum(total) AS total FROM comenzi WHERE client_id = 1 FOR UPDATE;
COMMIT;
După reparație, programul afișează
BEGIN
  total
---------
 3848.40
(1 rând)

COMMIT
Indiciu

SELECT sum(total) FROM (SELECT total FROM comenzi WHERE client_id = 1 FOR UPDATE) x

Alte forme ale mesajului

  • ERROR: FOR UPDATE is not allowed with GROUP BY clause
  • ERROR: FOR UPDATE is not allowed with DISTINCT clause

Cum o eviți pe viitor

  • Blochează rânduri concrete, în subinterogări sau comenzi separate, înainte de agregare.
  • Ține tranzacțiile cu blocaje cât mai scurte.
  • Blochează mereu în aceeași ordine (de exemplu ORDER BY id) ca să eviți blocajele reciproce.
  • Preferă UPDATE condiționate și constrângeri când pot înlocui o citire blocantă.

Întrebări frecvente

Ce diferență e între FOR UPDATE și FOR NO KEY UPDATE?

FOR NO KEY UPDATE e mai slab: nu blochează inserările în tabele care referă rândul prin cheie străină. Este blocajul luat automat de un UPDATE care nu schimbă cheia.

Blocajul se eliberează la finalul interogării?

Nu, la finalul tranzacției (COMMIT sau ROLLBACK).

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.