ERROR: unsafe use of new value "returnata" of enum type stare_comanda
Ai adăugat o valoare nouă într-un ENUM (ALTER TYPE ... ADD VALUE) și ai folosit-o în aceeași tranzacție. PostgreSQL permite folosirea valorii doar după ce tranzacția care a adăugat-o a fost confirmată. Pune ALTER TYPE într-o tranzacție (sau migrare) separată, înainte de folosire.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
ALTER TYPE ... ADD VALUE poate rula într-o tranzacție (din PostgreSQL 12), dar valoarea nouă nu poate fi folosită până la COMMIT. Motivul: dacă tranzacția ar fi anulată, rândurile sau indecșii care ar conține deja valoarea ar referi o etichetă care nu mai există. Mesajul vine cu HINT: New enum values must be committed before they can be used.
Problema apare des în migrări: instrumentele rulează fiecare fișier într-o tranzacție, iar fișierul adaugă valoarea și apoi actualizează date cu ea. Soluția: două migrări separate (prima adaugă valoarea, a doua o folosește) sau două tranzacții în același script. Dacă lista de stări se schimbă des, o constrângere CHECK sau un tabel de referință cu cheie străină evită complet această restricție.
De ce apare: cauzele frecvente
1Adăugare și folosire în aceeași tranzacție
BEGIN;
ALTER TYPE stare_comanda ADD VALUE 'returnata';
UPDATE comenzi SET stare = 'returnata' WHERE id = 2;
COMMIT;ALTER TYPE stare_comanda ADD VALUE 'returnata';
BEGIN;
UPDATE comenzi SET stare = 'returnata' WHERE id = 2;
COMMIT;Valoarea este confirmată înainte de folosire.
2Migrare unică
-- V20__stare_returnata.sql: ADD VALUE + UPDATE-- V20__adauga_returnata.sql: ALTER TYPE ... ADD VALUE
-- V21__foloseste_returnata.sql: UPDATE ...Fiecare pas în migrarea lui.
Repară eroarea, direct în pagină
Migrarea adaugă starea „returnata” în tipul stare_comanda și marchează imediat comanda 2 ca returnată, totul într-o tranzacție, și dă unsafe use of new value "returnata". Adaugă valoarea înainte de tranzacție, păstrează UPDATE-ul în tranzacție și afișează starea comenzilor.
BEGIN;
ALTER TYPE stare_comanda ADD VALUE 'returnata';
UPDATE comenzi SET stare = 'returnata' WHERE id = 2;
COMMIT;
SELECT id, stare FROM comenzi ORDER BY id;ALTER TYPE BEGIN UPDATE 1 COMMIT id | stare ----+----------- 1 | livrata 2 | returnata 3 | noua (3 rânduri)
Indiciu
ALTER TYPE ... ADD VALUE în afara blocului BEGIN ... COMMIT.
Reparația
ALTER TYPE stare_comanda ADD VALUE 'returnata';
BEGIN;
UPDATE comenzi SET stare = 'returnata' WHERE id = 2;
COMMIT;
SELECT id, stare FROM comenzi ORDER BY id;De ce merge
Valoarea nouă a unui ENUM nu poate fi folosită în tranzacția care a adăugat-o. Rulat separat, ALTER TYPE ... ADD VALUE se confirmă imediat, iar tranzacția următoare poate folosi eticheta. Comanda 2 apare cu starea „returnata”, iar celelalte își păstrează starea.
Cum o eviți pe viitor
- Adaugă valorile noi de ENUM în migrări separate, înaintea codului care le folosește.
- Folosește
ADD VALUE IF NOT EXISTS, ca migrarea să poată fi reluată. - Pentru stări care se schimbă des, folosește
CHECKsau un tabel de referință în locul ENUM. - Planifică ordinea de deploy: baza de date întâi, aplicația după.
Întrebări frecvente
Pot șterge o valoare dintr-un ENUM?
Nu direct. Trebuie creat un tip nou fără valoare, migrate coloanele și șters tipul vechi.
Ce face ADD VALUE ... BEFORE?
Inserează eticheta într-o anumită poziție, ceea ce contează pentru sortare și comparații.
Erori înrudite
ERROR: invalid input value for enum stare_comanda: "anulat" Valoarea nu este una dintre etichetele definite pentru tipul ENUM. Comparația e exactă, cu majuscule și diacritice: "anulat" nu e "anulata", "Noua" nu e "noua". Folosește o valoare existentă sau adaugă eticheta nouă cu ALTER TYPE ... ADD VALUE. 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ă. 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). Î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.
