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

ERROR: invalid transaction termination

Pe scurt

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.

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

Ce înseamnă

Din PostgreSQL 11, procedurile (CREATE PROCEDURE, apelate cu CALL) pot face COMMIT și ROLLBACK în interiorul lor, util pentru procesări în loturi care confirmă progresiv. Funcțiile nu pot: rulează întotdeauna în tranzacția instrucțiunii care le apelează. Mai mult, o procedură poate controla tranzacția doar dacă CALL este executat la nivelul cel mai de sus; dacă procedura e apelată într-un bloc deschis cu BEGIN, dintr-o funcție sau dintr-un bloc PL/pgSQL cu EXCEPTION, COMMIT dă această eroare.

Cazuri tipice: o funcție PL/pgSQL care încearcă să confirme după fiecare lot; un client (sau un ORM) care deschide automat o tranzacție înainte de CALL; o procedură cu COMMIT în interiorul unui bloc BEGIN ... EXCEPTION ... END. Soluția: procedură, apel CALL în autocommit și blocurile cu EXCEPTION mutate în jurul pașilor care nu fac commit.

De ce apare: cauzele frecvente

1COMMIT într-o funcție

Greșit
SQL
CREATE FUNCTION arhiveaza() RETURNS void LANGUAGE plpgsql AS $$ BEGIN ...; COMMIT; END $$;
Corect
SQL
CREATE PROCEDURE arhiveaza() LANGUAGE plpgsql AS $$ BEGIN ...; COMMIT; END $$;
CALL arhiveaza();

Doar procedurile pot controla tranzacția.

2CALL într-un bloc BEGIN

Greșit
SQL
BEGIN;
CALL arhiveaza();
COMMIT;
Corect
SQL
CALL arhiveaza();

Procedura trebuie apelată în afara unei tranzacții explicite.

Repară tu

Repară eroarea, direct în pagină

Procedura arhiveaza_vechi mută comenzile vechi în arhivă și face COMMIT, dar e apelată într-un bloc BEGIN ... COMMIT și dă invalid transaction termination. Apelează procedura direct cu CALL și afișează numărul de comenzi arhivate.

Codul care dă eroarea
SQL
BEGIN;
CALL arhiveaza_vechi();
COMMIT;
SELECT count(*) AS arhivate FROM comenzi_arhiva;
După reparație, programul afișează
CALL
 arhivate
----------
        1
(1 rând)
Indiciu

Scoate BEGIN și COMMIT din jurul lui CALL.

Cum o eviți pe viitor

  • Folosește proceduri pentru procesări în loturi care trebuie confirmate progresiv.
  • Apelează procedurile cu CALL în modul autocommit, nu în blocuri BEGIN.
  • Verifică dacă driverul sau ORM-ul deschide automat tranzacții.
  • Nu combina COMMIT în procedură cu blocuri EXCEPTION care îl înconjoară.

Întrebări frecvente

Cum apelez o procedură din Java fără tranzacție?

Cu conn.setAutoCommit(true) înainte de CALL.

O procedură poate întoarce rezultate?

Poate avea parametri OUT (sau INOUT), dar nu întoarce seturi de rânduri ca o funcție.

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.