ERROR: functions in index expression must be marked IMMUTABLE
Indexul pe expresie folosește o funcție care nu e IMMUTABLE, adică rezultatul ei poate depinde de setări sau de timp. Exemple: momentul::date pe un timestamptz (depinde de fusul orar), to_char, unaccent. Fixează dependența (fus orar explicit: (moment AT TIME ZONE 'Europe/Bucharest')::date) sau folosește o funcție imuabilă.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un index pe expresie stochează rezultatul expresiei pentru fiecare rând. Ca indexul să rămână corect, expresia trebuie să dea mereu același rezultat pentru aceleași valori, adică funcțiile folosite trebuie să fie IMMUTABLE. Funcțiile STABLE (care depind de setări ca TimeZone, DateStyle, search_path) și VOLATILE (now(), random()) sunt refuzate.
Cazul clasic: CREATE INDEX ON comenzi ((creat::date)) pe o coloană timestamptz. Conversia depinde de fusul orar al sesiunii, deci aceeași valoare poate da zile diferite. Varianta corectă fixează fusul: ((creat AT TIME ZONE 'Europe/Bucharest')::date), care e imuabilă. Alte cazuri: to_char(data, 'YYYY-MM') (depinde de localizare; folosește date_trunc pe timestamp fără fus), unaccent(text) (depinde de dicționar; se învelește într-o funcție imuabilă cu dicționarul explicit). Pentru a folosi indexul, interogarea trebuie să conțină exact aceeași expresie.
De ce apare: cauzele frecvente
1Ziua dintr-un timestamptz
CREATE INDEX ON comenzi_web ((creat::date));CREATE INDEX ON comenzi_web (((creat AT TIME ZONE 'Europe/Bucharest')::date));Cu fusul explicit, expresia nu mai depinde de sesiune.
2Formatare cu to_char
CREATE INDEX ON comenzi ((to_char(data, 'YYYY-MM')));CREATE INDEX ON comenzi ((date_trunc('month', data::timestamp)));date_trunc pe timestamp fără fus este imuabil.
Repară eroarea, direct în pagină
Tabelul comenzi_web are momentul plasării ca timestamptz, iar rapoartele filtrează după ziua calendaristică din România. Indexul pe (creat::date) dă functions in index expression must be marked IMMUTABLE. Creează indexul cu fusul orar explicit și afișează câte comenzi au fost plasate pe 14 martie 2025, ora României.
CREATE INDEX comenzi_web_zi_idx ON comenzi_web ((creat::date));
SELECT count(*) FROM comenzi_web
WHERE (creat AT TIME ZONE 'Europe/Bucharest')::date = '2025-03-14';CREATE INDEX
count
-------
2
(1 rând)Indiciu
((creat AT TIME ZONE 'Europe/Bucharest')::date)
Reparația
CREATE INDEX comenzi_web_zi_idx ON comenzi_web (((creat AT TIME ZONE 'Europe/Bucharest')::date));
SELECT count(*) FROM comenzi_web
WHERE (creat AT TIME ZONE 'Europe/Bucharest')::date = '2025-03-14';De ce merge
creat::date depinde de fusul orar al sesiunii, deci nu poate fi indexat. (creat AT TIME ZONE 'Europe/Bucharest')::date dă mereu aceeași zi pentru același moment și este imuabilă. Interogarea folosește exact aceeași expresie. Comanda plasată la 23:30 UTC pe 13 martie este pe 14 martie în România, deci rezultatul este 2.
Cum o eviți pe viitor
- Verifică volatilitatea funcțiilor cu
SELECT provolatile FROM pg_proc WHERE proname = '...'(i,s,v). - Pentru date calendaristice din
timestamptz, fixează fusul orar în expresie. - Scrie interogările cu exact aceeași expresie ca indexul, altfel indexul nu e folosit.
- Nu marca o funcție
IMMUTABLEdacă nu este cu adevărat: indexul poate deveni incorect fără avertisment.
Întrebări frecvente
Pot marca eu o funcție ca IMMUTABLE?
Da, pentru funcțiile proprii. Dacă rezultatul depinde totuși de setări, indexul poate conține valori greșite, deci fă asta doar când ești sigur.
O coloană generată ar fi o alternativă?
Da. Are aceeași restricție (expresia trebuie să fie imuabilă), dar valoarea poate fi apoi indexată și folosită direct în interogări.
Erori înrudite
ERROR: generation expression is not immutable 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. ERROR: text search configuration "romana" does not exist Numele configurației de căutare full-text nu există. Configurațiile au nume în engleză: pentru română este 'romanian', nu 'romana' sau 'ro'. Verifică lista cu \dF în psql sau SELECT cfgname FROM pg_ts_config. ERROR: cannot use column reference in DEFAULT expression Valoarea implicită (DEFAULT) a unei coloane nu poate folosi alte coloane ale rândului. DEFAULT poate fi doar o constantă sau o funcție (now(), gen_random_uuid()). Pentru valori calculate din alte coloane, folosește o coloană generată sau un trigger. Î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.
