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

ERROR: VACUUM cannot run inside a transaction block

Pe scurt

VACUUM (și CREATE DATABASE, DROP DATABASE, ALTER SYSTEM) nu poate rula într-o tranzacție deschisă cu BEGIN și nici într-o funcție. Rulează comanda separat, în modul autocommit, sau dintr-un job de mentenanță extern.

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

Ce înseamnă

VACUUM gestionează intern propriile tranzacții (mai ales cu FULL sau pe mai multe tabele), deci PostgreSQL îl refuză într-un bloc de tranzacție. Aceeași regulă se aplică și altor comenzi de administrare: CREATE DATABASE, DROP DATABASE, ALTER SYSTEM, CREATE TABLESPACE, REINDEX DATABASE. Mesajul are aceeași formă, cu numele comenzii.

Situații tipice: un script de mentenanță rulat printr-un client care deschide automat tranzacții (multe instrumente grafice, driverele cu autocommit dezactivat); o funcție PL/pgSQL care încearcă să ruleze VACUUM (funcțiile rulează mereu într-o tranzacție, deci nu se poate). Soluțiile: rulezi comanda direct în psql, activezi autocommit în driver sau programezi mentenanța cu vacuumdb, cron sau extensia pg_cron. ANALYZE singur, spre deosebire de VACUUM, poate rula într-o tranzacție.

De ce apare: cauzele frecvente

1VACUUM în script tranzacțional

Greșit
SQL
BEGIN;
DELETE FROM jurnal WHERE data < '2025-01-01';
VACUUM jurnal;
COMMIT;
Corect
SQL
DELETE FROM jurnal WHERE data < '2025-01-01';
VACUUM jurnal;

Fiecare comandă rulează separat, în autocommit.

2VACUUM într-o funcție

Greșit
SQL
CREATE FUNCTION curata() ... AS $$ BEGIN VACUUM jurnal; END $$;
Corect
SQL
-- programat extern:
-- vacuumdb --table=jurnal magazin
-- sau pg_cron: SELECT cron.schedule('0 3 * * *', 'VACUUM jurnal');

Mentenanța se programează în afara funcțiilor.

Repară tu

Repară eroarea, direct în pagină

Scriptul de curățenie șterge mesajele vechi din jurnal și rulează VACUUM ANALYZE, dar totul e într-un bloc BEGIN ... COMMIT și apare VACUUM cannot run inside a transaction block. Rulează comenzile separat și afișează numărul de rânduri rămase.

Codul care dă eroarea
SQL
BEGIN;
DELETE FROM jurnal WHERE data < '2025-01-01';
VACUUM ANALYZE jurnal;
COMMIT;
SELECT count(*) FROM jurnal;
După reparație, programul afișează
DELETE 2
VACUUM
 count
-------
     1
(1 rând)
Indiciu

Scoate BEGIN și COMMIT; DELETE și VACUUM rulează pe rând.

Alte forme ale mesajului

  • ERROR: CREATE DATABASE cannot run inside a transaction block
  • ERROR: ALTER SYSTEM cannot run inside a transaction block

Cum o eviți pe viitor

  • Rulează VACUUM și comenzile de administrare în sesiuni autocommit.
  • Lasă autovacuum să facă treaba de rutină; rulează manual doar după operații mari.
  • Programează mentenanța cu instrumente externe (vacuumdb, pg_cron).
  • Folosește ANALYZE singur când ai nevoie doar de statistici actualizate, chiar și în tranzacții.

Întrebări frecvente

Când rulez VACUUM manual?

După ștergeri sau actualizări masive, înainte de rapoarte importante sau când autovacuum nu ține pasul. În rest, autovacuum ajunge.

VACUUM FULL e mai bun?

Recuperează spațiul pe disc, dar rescrie tabelul cu blocaj exclusiv. Se folosește rar, în ferestre de mentenanță.

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.