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

ERROR: SAVEPOINT can only be used in transaction blocks

Pe scurt

Ai creat un SAVEPOINT (sau ai făcut ROLLBACK TO SAVEPOINT) fără o tranzacție deschisă cu BEGIN. Fără BEGIN, fiecare comandă e o tranzacție separată, confirmată imediat, deci n-ai la ce reveni. Deschide tranzacția cu BEGIN înainte de SAVEPOINT.

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

Ce înseamnă

Un savepoint marchează un punct în interiorul unei tranzacții, la care poți reveni cu ROLLBACK TO SAVEPOINT, fără să anulezi toată tranzacția. În modul implicit (autocommit), fiecare instrucțiune este propria tranzacție, deci nu există un context în care savepoint-ul să aibă sens. Variantele ROLLBACK TO SAVEPOINT can only be used in transaction blocks și RELEASE SAVEPOINT can only be used in transaction blocks au aceeași cauză.

Situații tipice: BEGIN uitat la începutul scriptului; un COMMIT sau ROLLBACK mai devreme a închis tranzacția; un client sau un pool de conexiuni în modul autocommit (de exemplu un instrument grafic care confirmă fiecare instrucțiune). În aplicații, savepoint-urile se folosesc prin API-ul driverului (conn.setSavepoint()), după ce autocommit e dezactivat.

De ce apare: cauzele frecvente

1BEGIN uitat

Greșit
SQL
SAVEPOINT inainte_de_import;
INSERT ...;
Corect
SQL
BEGIN;
SAVEPOINT inainte_de_import;
INSERT ...;
COMMIT;

Savepoint-ul există doar în interiorul tranzacției.

2Tranzacție închisă mai devreme

Greșit
SQL
BEGIN;
UPDATE ...;
COMMIT;
SAVEPOINT a;
Corect
SQL
BEGIN;
UPDATE ...;
SAVEPOINT a;
...
COMMIT;

COMMIT închide tranzacția; savepoint-ul trebuie creat înainte.

Repară tu

Repară eroarea, direct în pagină

Scriptul scade stocul laptopului, creează un savepoint, scade din nou din greșeală și revine la savepoint, dar lipsește BEGIN și apare SAVEPOINT can only be used in transaction blocks. Adaugă tranzacția (BEGIN la început, COMMIT la final) și afișează stocul laptopului.

Codul care dă eroarea
SQL
UPDATE produse SET stoc = stoc - 1 WHERE id = 1;
SAVEPOINT dupa_prima;
UPDATE produse SET stoc = stoc - 1 WHERE id = 1;
ROLLBACK TO SAVEPOINT dupa_prima;
SELECT stoc FROM produse WHERE id = 1;
După reparație, programul afișează
BEGIN
UPDATE 1
SAVEPOINT
UPDATE 1
ROLLBACK
COMMIT
 stoc
------
    4
(1 rând)
Indiciu

BEGIN; ... COMMIT;

Alte forme ale mesajului

  • ERROR: ROLLBACK TO SAVEPOINT can only be used in transaction blocks

Cum o eviți pe viitor

  • Începe explicit cu BEGIN orice script care folosește savepoint-uri.
  • Verifică modul autocommit al clientului sau al driverului.
  • Folosește nume clare pentru savepoint-uri (inainte_de_import).
  • Închide tranzacția o singură dată, la final.
  • Rulează scripturile cu \set ON_ERROR_STOP on, ca o eroare să nu treacă neobservată.

Întrebări frecvente

Pot avea mai multe savepoint-uri?

Da, oricâte, chiar cu același nume; ROLLBACK TO revine la cel mai recent cu acel nume.

Ce face RELEASE SAVEPOINT?

Renunță la savepoint, păstrând modificările făcute după el. Nu confirmă nimic; confirmarea se face la COMMIT.

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.