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

ERROR: cannot refresh materialized view "public.raport_lunar" concurrently

Pe scurt

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

Greșit
SQL
REFRESH MATERIALIZED VIEW CONCURRENTLY raport_lunar;
Corect
SQL
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

Greșit
SQL
CREATE UNIQUE INDEX ON raport_lunar (luna) WHERE luna IS NOT NULL;
Corect
SQL
CREATE UNIQUE INDEX ON raport_lunar (luna);

Indexul trebuie să acopere toate rândurile, fără WHERE.

Repară tu

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.

Codul care dă eroarea
SQL
REFRESH MATERIALIZED VIEW CONCURRENTLY raport_lunar;
SELECT luna, total FROM raport_lunar ORDER BY luna;
După reparație, programul afișează
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)

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 CONCURRENTLY pentru 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

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