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

ERROR: SET TRANSACTION ISOLATION LEVEL must be called before any query

Pe scurt

Ai schimbat nivelul de izolare după ce tranzacția a rulat deja o interogare. Nivelul se stabilește la început, pentru că determină imaginea datelor (snapshot-ul). Scrie nivelul direct în BEGIN (BEGIN ISOLATION LEVEL REPEATABLE READ) sau ca primă comandă după BEGIN.

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

Ce înseamnă

Nivelul de izolare (READ COMMITTED, implicit, REPEATABLE READ, SERIALIZABLE) decide ce date vede tranzacția. La REPEATABLE READ și SERIALIZABLE, imaginea datelor (snapshot-ul) se fixează la prima interogare din tranzacție. Schimbarea nivelului după acest moment nu ar avea sens, așa că PostgreSQL refuză. Aceeași regulă se aplică la SET TRANSACTION READ ONLY sau DEFERRABLE după prima interogare.

Forma cea mai clară este BEGIN ISOLATION LEVEL REPEATABLE READ;. În aplicații, nivelul se setează prin driver (conn.setTransactionIsolation(...), adnotarea @Transactional(isolation = ...) din Spring) înainte de prima instrucțiune. Pentru o sesiune întreagă, SET SESSION CHARACTERISTICS AS TRANSACTION ISOLATION LEVEL ... stabilește nivelul implicit pentru tranzacțiile următoare.

De ce apare: cauzele frecvente

1Nivel setat după o interogare

Greșit
SQL
BEGIN;
SELECT count(*) FROM comenzi;
SET TRANSACTION ISOLATION LEVEL REPEATABLE READ;
Corect
SQL
BEGIN ISOLATION LEVEL REPEATABLE READ;
SELECT count(*) FROM comenzi;

Nivelul e stabilit înainte de prima interogare.

2Nivel pentru toată sesiunea

Greșit
SQL
-- SET TRANSACTION în fiecare tranzacție
Corect
SQL
SET SESSION CHARACTERISTICS AS TRANSACTION ISOLATION LEVEL REPEATABLE READ;

Toate tranzacțiile următoare din sesiune folosesc nivelul.

Repară tu

Repară eroarea, direct în pagină

Raportul de sfârșit de zi are nevoie de o imagine consistentă a datelor (REPEATABLE READ), dar setează nivelul după prima interogare și dă SET TRANSACTION ISOLATION LEVEL must be called before any query. Stabilește nivelul în BEGIN și afișează nivelul curent și numărul de comenzi.

Codul care dă eroarea
SQL
BEGIN;
SELECT count(*) AS comenzi FROM comenzi;
SET TRANSACTION ISOLATION LEVEL REPEATABLE READ;
SELECT current_setting('transaction_isolation') AS nivel;
COMMIT;
După reparație, programul afișează
BEGIN
      nivel      | comenzi
-----------------+---------
 repeatable read |       3
(1 rând)

COMMIT
Indiciu

BEGIN ISOLATION LEVEL REPEATABLE READ;

Cum o eviți pe viitor

  • Scrie nivelul de izolare direct în BEGIN.
  • În aplicații, setează-l prin driver sau framework, nu prin SQL în mijlocul tranzacției.
  • Alege REPEATABLE READ pentru rapoarte consistente și SERIALIZABLE pentru reguli de business complexe.
  • Pregătește aplicația să reia tranzacțiile care primesc erori de serializare (SQLSTATE 40001).

Întrebări frecvente

Ce nivel folosește PostgreSQL implicit?

READ COMMITTED: fiecare instrucțiune vede datele confirmate în momentul în care începe.

READ UNCOMMITTED există?

Se acceptă ca sintaxă, dar în PostgreSQL se comportă ca READ COMMITTED; nu există citiri murdare.

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.