ERROR: cannot refresh materialized view "public.raport_lunar" concurrently
REFRESH MATERIALIZED VIEW CONCURRENTLY cere un index unic pe view-ul materializat, ca să poată compara rândurile vechi cu cele noi. Creează un index unic pe coloanele care identifică un rând (de exemplu luna) și rulează din nou.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un REFRESH obișnuit înlocuiește tot conținutul view-ului și ia un blocaj exclusiv: cât durează, nimeni nu poate citi view-ul. Varianta CONCURRENTLY calculează rezultatul nou separat, îl compară cu cel vechi și aplică doar diferențele, iar cititorii nu sunt blocați. Pentru comparație, PostgreSQL are nevoie să identifice fiecare rând, deci cere un index unic, pe coloane simple (nu pe expresii și fără WHERE), care să acopere toate rândurile. Fără el apare această eroare, cu HINT: Create a unique index with no WHERE clause on one or more columns of the materialized view.
Varianta concurentă e mai lentă decât refresh-ul complet și nu poate fi folosită la primul refresh. Merită pentru rapoarte citite des, unde câteva secunde sau minute de indisponibilitate ar deranja.
De ce apare: cauzele frecvente
1Lipsește indexul unic
REFRESH MATERIALIZED VIEW CONCURRENTLY raport_lunar;CREATE UNIQUE INDEX raport_lunar_luna_idx ON raport_lunar (luna);
REFRESH MATERIALIZED VIEW CONCURRENTLY raport_lunar;Indexul unic permite compararea rândurilor.
2Index unic parțial
CREATE UNIQUE INDEX ON raport_lunar (luna) WHERE luna IS NOT NULL;CREATE UNIQUE INDEX ON raport_lunar (luna);Indexul trebuie să acopere toate rândurile, fără WHERE.
Repară eroarea, direct în pagină
Raportul raport_lunar este citit continuu de dashboard, iar refresh-ul cu CONCURRENTLY dă cannot refresh materialized view "public.raport_lunar" concurrently. Creează indexul unic necesar pe coloana luna, rulează refresh-ul concurent și afișează raportul.
REFRESH MATERIALIZED VIEW CONCURRENTLY raport_lunar;
SELECT luna, total FROM raport_lunar ORDER BY luna;CREATE INDEX
REFRESH MATERIALIZED VIEW
luna | total
------------+---------
2025-03-01 | 5147.40
2025-04-01 | 59.50
(2 rânduri)Indiciu
CREATE UNIQUE INDEX ... ON raport_lunar (luna)
Reparația
CREATE UNIQUE INDEX raport_lunar_luna_idx ON raport_lunar (luna);
REFRESH MATERIALIZED VIEW CONCURRENTLY raport_lunar;
SELECT luna, total FROM raport_lunar ORDER BY luna;De ce merge
Refresh-ul concurent compară rândurile vechi cu cele noi, deci are nevoie de un index unic care să le identifice. Luna este cheia grupării din interogarea view-ului, deci e unică. După crearea indexului, refresh-ul concurent reușește, iar comanda adăugată în aprilie apare ca rând nou, fără să fi blocat cititorii.
Cum o eviți pe viitor
- Creează indexul unic împreună cu view-ul materializat, în aceeași migrare.
- Alege coloane care chiar identifică un rând (cheia grupării din interogare).
- Folosește
CONCURRENTLYpentru view-uri citite în timpul refresh-ului; altfel refresh-ul simplu e mai rapid. - Monitorizează durata refresh-urilor, mai ales pe măsură ce datele cresc.
Întrebări frecvente
De ce e refresh-ul concurent mai lent?
Pentru că face o comparație între rezultatul vechi și cel nou și aplică diferențele rând cu rând, în loc să înlocuiască tot.
Pot rula două refresh-uri concurente simultan?
Nu. Al doilea așteaptă terminarea primului.
Erori înrudite
ERROR: materialized view "raport_lunar" has not been populated View-ul materializat a fost creat cu WITH NO DATA (sau restaurat așa) și nu a fost încă umplut. Nu poate fi citit până la primul REFRESH. Rulează REFRESH MATERIALIZED VIEW raport_lunar o dată, apoi interogările merg. ERROR: could not create unique index "clienti_email_key" Încerci să adaugi o constrângere UNIQUE (sau un index unic, sau o cheie primară) pe o coloană care are deja valori duplicate. DETAIL arată prima pereche duplicată. Găsește și rezolvă duplicatele (șterge, combină sau corectează), apoi creează din nou constrângerea. ERROR: cannot insert into view "v_totaluri" View-ul nu este actualizabil automat, pentru că conține agregate, GROUP BY, DISTINCT, JOIN-uri sau UNION. PostgreSQL nu poate ști în ce tabel să scrie. Scrie direct în tabelul de bază sau definește un trigger INSTEAD OF pe view. Î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.
