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

ERROR: unsafe use of new value "returnata" of enum type stare_comanda

Pe scurt

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

Greșit
SQL
BEGIN;
ALTER TYPE stare_comanda ADD VALUE 'returnata';
UPDATE comenzi SET stare = 'returnata' WHERE id = 2;
COMMIT;
Corect
SQL
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ă

Greșit
SQL
-- V20__stare_returnata.sql: ADD VALUE + UPDATE
Corect
SQL
-- V20__adauga_returnata.sql: ALTER TYPE ... ADD VALUE
-- V21__foloseste_returnata.sql: UPDATE ...

Fiecare pas în migrarea lui.

Repară tu

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.

Codul care dă eroarea
SQL
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;
După reparație, programul afișează
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.

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 CHECK sau 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

← 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.