...
Eroare PostgreSQL · Sintaxă și nume de obiecte

ERROR: relation "produse" does not exist

Pe scurt

PostgreSQL nu găsește tabelul (sau view-ul, secvența) cu acest nume în schemele din search_path. Verifică dacă tabelul există, dacă ești conectat la baza de date corectă, dacă e într-o altă schemă și dacă a fost creat cu majuscule între ghilimele.

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

Ce înseamnă

„Relation” este termenul PostgreSQL pentru tabele, view-uri, vederi materializate, secvențe și indecși. Mesajul spune că numele căutat nu există în nicio schemă din search_path (implicit "$user", public).

Cauzele frecvente: tabelul nu a fost creat încă (migrarea nu a rulat), ești conectat la altă bază de date decât crezi (\conninfo în psql), tabelul e în altă schemă (vanzari.produse), sau a fost creat de un ORM cu majuscule ("Produse"), caz în care trebuie scris exact așa, cu ghilimele. Același mesaj apare și la funcții care primesc nume de tabel ca text, ca pg_relation_size('produse') sau 'produse'::regclass, și la nextval cu o secvență inexistentă.

De ce apare: cauzele frecvente

1Tabelul este în altă schemă

Greșit
SQL
SELECT * FROM produse;  -- tabelul e în schema magazin
Corect
SQL
SELECT * FROM magazin.produse;
-- sau: SET search_path = magazin, public;

Fără prefix, PostgreSQL caută doar în schemele din search_path. Calificarea cu schema sau schimbarea search_path rezolvă căutarea.

2Tabel creat cu majuscule de un ORM

Greșit
SQL
CREATE TABLE "Produse" (id int);
SELECT * FROM Produse;
Corect
SQL
SELECT * FROM "Produse";

Fără ghilimele, Produse devine produse, care nu există. Numele creat cu ghilimele trebuie citat la fel.

3Baza de date greșită

Greșit
SQL
-- conectat la postgres, nu la magazin
SELECT * FROM produse;
Corect
SQL
\c magazin
SELECT * FROM produse;

Fiecare bază de date are propriile tabele. Verifici cu \conninfo și te conectezi la baza corectă.

4Tabelul nu a fost creat

Greșit
SQL
SELECT * FROM produse;
Corect
SQL
CREATE TABLE produse (id int PRIMARY KEY, nume text);
SELECT * FROM produse;

Dacă migrarea nu a rulat, tabelul nu există. Creezi tabelul sau rulezi migrările aplicației.

Repară tu

Repară eroarea, direct în pagină

Raportul folosește tabelul de produse din schema magazin, dar dă relation "produse" does not exist. Repară interogarea ca să afișeze numele și prețul produselor, de la cel mai scump.

Codul care dă eroarea
SQL
SELECT nume, pret
FROM produse
ORDER BY pret DESC;
După reparație, programul afișează
      nume      |  pret
----------------+---------
 Laptop Nova    | 3499.90
 Monitor 27     | 1299.00
 Mouse Wireless |   59.50
(3 rânduri)
Indiciu

Tabelul nu se află în schema public.

Alte forme ale mesajului

  • ERROR: relation "magazin.produse" does not exist
  • ERROR: relation "nu_seq" does not exist

Cum o eviți pe viitor

  • Verifică ce tabele vezi cu \dt *.* sau SELECT schemaname, tablename FROM pg_tables.
  • Folosește nume de tabele cu litere mici și fără ghilimele.
  • Setează explicit search_path pentru rolul aplicației, dacă folosești scheme proprii.
  • În testele automate, rulează migrările înainte de teste și pornește de la o bază curată.

Întrebări frecvente

Tabelul apare în pgAdmin, dar interogarea tot dă eroare. De ce?

De obicei ești conectat la altă bază de date sau tabelul e în altă schemă decât public. Verifică numele complet (schema.tabel) în pgAdmin și conexiunea folosită de interogare.

Ce diferență e între relation și table în mesaj?

Niciuna practică: PostgreSQL numește „relation” orice obiect de tip tabel, inclusiv view-uri, secvențe și indecși.

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.