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

ERROR: functions in index expression must be marked IMMUTABLE

Pe scurt

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

Greșit
SQL
CREATE INDEX ON comenzi_web ((creat::date));
Corect
SQL
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

Greșit
SQL
CREATE INDEX ON comenzi ((to_char(data, 'YYYY-MM')));
Corect
SQL
CREATE INDEX ON comenzi ((date_trunc('month', data::timestamp)));

date_trunc pe timestamp fără fus este imuabil.

Repară tu

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.

Codul care dă eroarea
SQL
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';
După reparație, programul afișează
CREATE INDEX
 count
-------
     2
(1 rând)
Indiciu

((creat AT TIME ZONE 'Europe/Bucharest')::date)

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 IMMUTABLE dacă 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

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