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

ERROR: materialized view "raport_lunar" has not been populated

Pe scurt

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.

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

Ce înseamnă

Un view materializat stochează pe disc rezultatul interogării lui. Creat cu WITH NO DATA, are structura, dar nu are rânduri și este marcat „nepopulat”; orice SELECT dă această eroare, cu HINT: Use the REFRESH MATERIALIZED VIEW command. Același lucru se întâmplă după unele restaurări sau când migrarea creează view-ul fără date ca să nu blocheze pornirea.

Soluția este REFRESH MATERIALIZED VIEW raport_lunar, care rulează interogarea și salvează rezultatul. Primul refresh nu poate fi CONCURRENTLY, pentru că view-ul nu are încă date. După aceea, refresh-ul se programează periodic (cron, pg_cron sau un job al aplicației). Starea se vede în pg_matviews.ispopulated. Un view nepopulat e diferit de un view gol: cel gol se poate citi și dă zero rânduri.

De ce apare: cauzele frecvente

1View creat fără date

Greșit
SQL
CREATE MATERIALIZED VIEW raport_lunar AS SELECT ... WITH NO DATA;
SELECT * FROM raport_lunar;
Corect
SQL
REFRESH MATERIALIZED VIEW raport_lunar;
SELECT * FROM raport_lunar;

Primul refresh umple view-ul.

2Primul refresh cu CONCURRENTLY

Greșit
SQL
REFRESH MATERIALIZED VIEW CONCURRENTLY raport_lunar;  -- nepopulat
Corect
SQL
REFRESH MATERIALIZED VIEW raport_lunar;

Varianta concurentă cere un view deja populat.

Repară tu

Repară eroarea, direct în pagină

Migrarea a creat view-ul materializat raport_lunar cu WITH NO DATA, iar raportul dă materialized view "raport_lunar" has not been populated. Umple view-ul și afișează luna și totalul, ordonate după lună.

Codul care dă eroarea
SQL
SELECT luna, total FROM raport_lunar ORDER BY luna;
După reparație, programul afișează
REFRESH MATERIALIZED VIEW
    luna    |  total
------------+---------
 2025-03-01 | 5147.40
(1 rând)
Indiciu

REFRESH MATERIALIZED VIEW raport_lunar

Cum o eviți pe viitor

  • Fă primul REFRESH imediat după crearea cu WITH NO DATA, ca pas explicit al migrării.
  • Programează refresh-urile periodice și monitorizează-le.
  • Verifică pg_matviews.ispopulated în scripturile de pornire sau de sănătate.
  • Documentează cât de „vechi” pot fi datele dintr-un view materializat, ca utilizatorii să știe.

Întrebări frecvente

De ce aș crea un view fără date?

Ca migrarea să fie rapidă și să nu blocheze tabelele mari; refresh-ul se face apoi separat.

Se actualizează automat?

Nu. Datele rămân cele de la ultimul REFRESH.

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.