ERROR: cannot execute UPDATE in a read-only transaction
Tranzacția sau sesiunea este doar pentru citire (READ ONLY), iar tu încerci să modifici date. Apare pe replici (hot standby), cu default_transaction_read_only = on sau în tranzacții deschise cu BEGIN READ ONLY. Trimite scrierile la serverul primar sau deschide o tranzacție READ WRITE.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul numește comanda refuzată (UPDATE, INSERT, CREATE TABLE, nextval()) și apare în trei situații. Prima: tranzacția a fost deschisă explicit BEGIN READ ONLY sau SET TRANSACTION READ ONLY, de exemplu pentru rapoarte. A doua: setarea default_transaction_read_only este activă pe sesiune, rol sau bază de date, de obicei intenționat, pentru utilizatori de raportare. A treia, cea mai frecventă în producție: conexiunea a ajuns pe o replică (hot standby), unde orice scriere e imposibilă.
Pe replici, mesajul poate fi și cannot execute UPDATE during recovery. Soluția este rutarea corectă: scrierile merg pe primar (de exemplu cu target_session_attrs=read-write în șirul de conexiune), iar citirile pot merge pe replici. Verifică starea cu SHOW transaction_read_only și SELECT pg_is_in_recovery().
De ce apare: cauzele frecvente
1Tranzacție de raport refolosită pentru scriere
BEGIN READ ONLY;
UPDATE produse SET stoc = 0 WHERE id = 4;BEGIN; -- implicit READ WRITE
UPDATE produse SET stoc = 0 WHERE id = 4;
COMMIT;Tranzacțiile care scriu nu trebuie deschise ca doar citire.
2Conexiune pe replică
jdbc:postgresql://replica:5432/magazinjdbc:postgresql://primar:5432,replica:5432/magazin?targetServerType=primaryDriverul alege serverul care acceptă scrieri.
Repară eroarea, direct în pagină
Scriptul de mentenanță marchează monitorul ca epuizat, dar a fost copiat dintr-un raport și deschide tranzacția cu BEGIN READ ONLY, deci dă cannot execute UPDATE in a read-only transaction. Deschide o tranzacție obișnuită, confirmă și afișează stocul monitorului.
BEGIN READ ONLY;
UPDATE produse SET stoc = 0 WHERE id = 4;
COMMIT;
SELECT stoc FROM produse WHERE id = 4;BEGIN
UPDATE 1
COMMIT
stoc
------
0
(1 rând)Indiciu
BEGIN fără READ ONLY
Reparația
BEGIN;
UPDATE produse SET stoc = 0 WHERE id = 4;
COMMIT;
SELECT stoc FROM produse WHERE id = 4;De ce merge
BEGIN READ ONLY interzice orice modificare de date în tranzacție. O tranzacție deschisă cu BEGIN simplu este implicit READ WRITE, deci UPDATE-ul reușește și COMMIT îl salvează. Stocul monitorului este setat la 0. Tranzacțiile READ ONLY rămân potrivite pentru rapoarte, unde protejează datele de modificări accidentale.
Alte forme ale mesajului
ERROR: cannot execute INSERT in a read-only transactionERROR: cannot execute UPDATE during recovery
Cum o eviți pe viitor
- Separă clar conexiunile de citire (replici) de cele de scriere (primar).
- Folosește
BEGIN READ ONLYdoar pentru rapoarte, nu pentru fluxuri mixte. - Configurează driverul cu atributul de sesiune potrivit (
target_session_attrs,targetServerType). - Verifică
pg_is_in_recovery()când apar erori de scriere neașteptate.
Întrebări frecvente
De ce ar folosi cineva tranzacții READ ONLY?
Pentru siguranță în rapoarte și pentru SERIALIZABLE READ ONLY DEFERRABLE, care rulează fără risc de erori de serializare.
nextval e considerat scriere?
Da. Secvențele nu pot avansa într-o tranzacție doar pentru citire sau pe replică.
Erori înrudite
ERROR: permission denied for table comenzi Rolul cu care rulezi nu are dreptul cerut (SELECT, INSERT, UPDATE, DELETE) pe tabel. Proprietarul tabelului sau un administrator trebuie să-l acorde cu GRANT. Acordă doar drepturile necesare, de preferat unui rol de grup, nu fiecărui utilizator. 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: SET TRANSACTION ISOLATION LEVEL must be called before any query 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. Î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.
