...
Eroare PostgreSQL · Tabele, view-uri, indecși și partiții

ERROR: generation expression is not immutable

Pe scurt

Coloana generată folosește o expresie care nu e imuabilă: now(), current_date, conversii dependente de fusul orar sau funcții STABLE. Valoarea unei coloane generate trebuie să depindă doar de celelalte coloane ale rândului. Pentru momentul creării folosește DEFAULT now(); pentru calcule pe date, fixează fusul orar.

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

Ce înseamnă

O coloană generată (GENERATED ALWAYS AS (expresie) STORED sau, din PostgreSQL 18, VIRTUAL) se calculează din celelalte coloane ale aceluiași rând. PostgreSQL cere ca expresia să fie imuabilă, ca valoarea să rămână corectă oricând ar fi recalculată. Expresii refuzate: now(), current_date, age(data) (depinde de data curentă), creat::date pe timestamptz (depinde de fus), to_char(...).

Confuzia frecventă este între coloana generată și valoarea implicită. Dacă vrei momentul inserării, folosește DEFAULT now(): se calculează o singură dată, la INSERT. Dacă vrei o valoare derivată care depinde de timpul curent (vârsta, zile rămase), calcul-o la citire, într-un view sau în interogare. Pentru calcule pe timestamptz, fixează fusul (AT TIME ZONE 'Europe/Bucharest'), ca expresia să devină imuabilă.

De ce apare: cauzele frecvente

1Momentul creării ca coloană generată

Greșit
SQL
ALTER TABLE comenzi ADD COLUMN creat timestamptz GENERATED ALWAYS AS (now()) STORED;
Corect
SQL
ALTER TABLE comenzi ADD COLUMN creat timestamptz NOT NULL DEFAULT now();

DEFAULT se evaluează o singură dată, la inserare.

2Vârsta calculată din data nașterii

Greșit
SQL
varsta int GENERATED ALWAYS AS (extract(year FROM age(data_nasterii))) STORED
Corect
SQL
-- la citire:
SELECT extract(year FROM age(data_nasterii)) AS varsta FROM persoane;

Valorile care depind de ziua de azi se calculează la interogare.

3Ziua locală dintr-un timestamptz

Greșit
SQL
zi date GENERATED ALWAYS AS (creat::date) STORED
Corect
SQL
zi date GENERATED ALWAYS AS ((creat AT TIME ZONE 'Europe/Bucharest')::date) STORED

Cu fusul fixat, expresia e imuabilă.

Repară tu

Repară eroarea, direct în pagină

Tabelul tichete trebuie să rețină momentul creării fiecărui tichet. Coloana creat definită ca GENERATED ALWAYS AS (now()) STORED dă generation expression is not immutable. Definește coloana cu valoare implicită now(), apoi inserează un tichet și afișează dacă momentul e completat.

Codul care dă eroarea
SQL
CREATE TABLE tichete (id int GENERATED ALWAYS AS IDENTITY PRIMARY KEY, subiect text, creat timestamptz GENERATED ALWAYS AS (now()) STORED);
INSERT INTO tichete (subiect) VALUES ('Parolă uitată');
SELECT subiect, creat IS NOT NULL AS are_moment FROM tichete;
După reparație, programul afișează
CREATE TABLE
INSERT 0 1
    subiect    | are_moment
---------------+------------
 Parolă uitată | t
(1 rând)
Indiciu

creat timestamptz NOT NULL DEFAULT now()

Cum o eviți pe viitor

  • Folosește coloane generate doar pentru valori derivate exclusiv din rând (totaluri, coduri, forme normalizate).
  • Folosește DEFAULT pentru valori calculate o dată, la inserare.
  • Calculează la citire valorile care depind de timpul curent.
  • Fixează fusul orar în orice expresie stocată care lucrează cu timestamptz.

Întrebări frecvente

Este now() imuabil în tranzacție?

Întoarce aceeași valoare în toată tranzacția, dar e STABLE, nu IMMUTABLE, pentru că se schimbă între tranzacții.

Ce diferență e între STORED și VIRTUAL?

STORED salvează valoarea pe disc la scriere; VIRTUAL (implicit în PostgreSQL 18) o calculează la fiecare citire. Ambele cer expresii imuabile.

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.