ERROR: VACUUM cannot run inside a transaction block
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
BEGIN;
DELETE FROM jurnal WHERE data < '2025-01-01';
VACUUM jurnal;
COMMIT;DELETE FROM jurnal WHERE data < '2025-01-01';
VACUUM jurnal;Fiecare comandă rulează separat, în autocommit.
2VACUUM într-o funcție
CREATE FUNCTION curata() ... AS $$ BEGIN VACUUM jurnal; END $$;-- 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ă 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.
BEGIN;
DELETE FROM jurnal WHERE data < '2025-01-01';
VACUUM ANALYZE jurnal;
COMMIT;
SELECT count(*) FROM jurnal;DELETE 2
VACUUM
count
-------
1
(1 rând)Indiciu
Scoate BEGIN și COMMIT; DELETE și VACUUM rulează pe rând.
Reparația
DELETE FROM jurnal WHERE data < '2025-01-01';
VACUUM ANALYZE jurnal;
SELECT count(*) FROM jurnal;De ce merge
Ștergerea poate rula singură, iar VACUUM ANALYZE trebuie să ruleze în afara oricărei tranzacții explicite. Fără bloc, DELETE-ul se confirmă imediat, apoi VACUUM marchează spațiul rândurilor șterse ca reutilizabil și actualizează statisticile. Rămâne un singur rând, cel din martie. În producție, autovacuum face de obicei acest lucru singur.
Alte forme ale mesajului
ERROR: CREATE DATABASE cannot run inside a transaction blockERROR: 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
ANALYZEsingur 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
ERROR: CREATE INDEX CONCURRENTLY cannot run inside a transaction block CREATE INDEX CONCURRENTLY folosește mai multe tranzacții interne, deci nu poate rula într-un bloc BEGIN ... COMMIT. Multe instrumente de migrări pun fiecare fișier într-o tranzacție. Rulează comanda separat, în afara tranzacției (în Flyway sau Liquibase, dezactivează tranzacția pentru acea migrare). ERROR: invalid transaction termination Ai folosit COMMIT sau ROLLBACK într-un loc unde nu e permis: într-o funcție (doar procedurile pot controla tranzacții) sau într-o procedură apelată dintr-o tranzacție deschisă explicit, cu BEGIN. Transformă funcția în procedură și apeleaz-o cu CALL, în afara unui bloc BEGIN. ERROR: current transaction is aborted, commands ignored until end of transaction block O comandă anterioară din aceeași tranzacție a dat eroare, iar PostgreSQL ignoră toate comenzile următoare până la ROLLBACK. Mesajul nu e cauza, ci consecința: caută prima eroare din tranzacție. Rulează ROLLBACK (sau ROLLBACK TO SAVEPOINT) și evită eroarea inițială. Î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.
