...
Eroare PostgreSQL · Roluri, drepturi, configurare și conexiuni

ERROR: role "raport" does not exist

Pe scurt

Numele rolului (utilizatorului) din GRANT, SET ROLE, ALTER ... OWNER sau din conexiune nu există în cluster. De obicei e o greșeală de scriere sau rolul a fost creat pe alt server. Verifică lista cu \du și creează rolul dacă lipsește.

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

Ce înseamnă

Rolurile sunt comune întregului cluster PostgreSQL (nu unei baze de date) și se creează cu CREATE ROLE sau CREATE USER (care e un rol cu LOGIN). Mesajul apare la GRANT ... TO, SET ROLE, ALTER ... OWNER TO, REASSIGN OWNED sau la conectare (FATAL: role "x" does not exist). Clientul psql folosește implicit numele utilizatorului din sistemul de operare, de unde eroarea frecventă role "root" does not exist sau role "ubuntu" does not exist la prima conectare.

Cauze: greșeli de scriere; rolul există pe serverul de dezvoltare, dar nu și în producție (rolurile nu sunt incluse în pg_dump al unei baze, ci în pg_dumpall --roles-only); nume cu majuscule create între ghilimele. Scripturile de inițializare ar trebui să creeze rolurile idempotent, de exemplu cu un bloc DO care verifică pg_roles.

De ce apare: cauzele frecvente

1Nume scris greșit

Greșit
SQL
GRANT SELECT ON comenzi TO raport;
Corect
SQL
GRANT SELECT ON comenzi TO raportare;

Numele rolului trebuie să fie exact.

2Conectare fără utilizator

Greșit
SQL
psql magazin  -- utilizatorul sistemului: root
Corect
SQL
psql -U postgres magazin

Utilizatorul PostgreSQL se dă explicit.

3Rol lipsă la restaurarea pe alt server

Greșit
SQL
pg_restore ... -- ERROR: role "app" does not exist
Corect
SQL
pg_dumpall --roles-only > roluri.sql  # pe sursă
psql -f roluri.sql  # pe destinație, înainte de restaurare

Rolurile se migrează separat de baze.

Repară tu

Repară eroarea, direct în pagină

Scriptul de drepturi acordă SELECT pe comenzi rolului raport, dar rolul se numește raportare, iar comanda dă role "raport" does not exist. Corectează numele și afișează dacă raportare poate citi tabelul comenzi.

Codul care dă eroarea
SQL
GRANT SELECT ON comenzi TO raport;
SELECT has_table_privilege('raportare', 'comenzi', 'SELECT') AS poate_citi;
După reparație, programul afișează
GRANT
 poate_citi
------------
 t
(1 rând)
Indiciu

has_table_privilege('raportare', 'comenzi', 'SELECT')

Alte forme ale mesajului

  • FATAL: role "root" does not exist

Cum o eviți pe viitor

  • Creează rolurile în scripturi versionate, înaintea bazelor de date care le folosesc.
  • Exportă rolurile cu pg_dumpall --roles-only la migrarea între servere.
  • Folosește nume de roluri cu litere mici, fără ghilimele.
  • Verifică rolurile cu \du înainte de GRANT-uri în producție.

Întrebări frecvente

Ce diferență e între CREATE USER și CREATE ROLE?

CREATE USER este CREATE ROLE ... LOGIN. Rolurile fără LOGIN se folosesc ca grupuri de drepturi.

Cum creez un rol doar dacă nu există?

Cu un bloc DO $$ BEGIN IF NOT EXISTS (SELECT FROM pg_roles WHERE rolname = 'app') THEN CREATE ROLE app; END IF; END $$;

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.