...
← Curs PostgreSQL: toate lecțiile
Lecția 9 · Introducere

Cum citești o eroare PostgreSQL

Erorile nu sunt dușmanul tău: PostgreSQL îți spune foarte precis ce nu i-a plăcut, unde și, de multe ori, cum să repari. Programatorii cu experiență nu știu mai mult SQL pe de rost, ci citesc mai bine erorile. În această lecție înveți structura unui mesaj de eroare și repari un script cu trei greșeli.

Părțile unui mesaj de eroare

Un mesaj de eroare PostgreSQL are mai multe rânduri, fiecare cu un rol precis. Nu apar toate de fiecare dată:

RândCe îți spune
ERROR:mesajul principal: ce s-a întâmplat
LINE n: + ^rândul din instrucțiune și locul exact (semnul ^) unde serverul a găsit problema
DETAIL:de ce: de exemplu, ce valoare există deja
HINT:ce poți face: o sugestie de reparație
CONTEXT:în ce funcție sau trigger a apărut eroarea (o vei vedea la PL/pgSQL)

Mesajele serverului sunt în engleză pe orice instalare obișnuită. În laborator, sub fiecare eroare apare și o explicație în română.

LINE și HINT: o coloană scrisă greșit

Ca să vedem mai multe erori în același script, folosim \set ON_ERROR_STOP off (fără el, scriptul se oprește la prima eroare, ca psql în modul strict):

\set ON_ERROR_STOP off
SELECT nume,
       prett
FROM produse;
SELECT * FROM produs;
ERROR:  column "prett" does not exist
LINE 2:        prett
               ^
HINT:  Perhaps you meant to reference the column "produse.pret".
ERROR:  relation "produs" does not exist
LINE 1: SELECT * FROM produs;
                      ^
1
column "prett" does not exist: coloana nu există.
2
LINE 2: problema este pe al doilea rând al instrucțiunii, iar ^ stă sub cuvântul greșit.
3
HINT: PostgreSQL a găsit o coloană cu nume asemănător și îți propune produse.pret.
4
relation "produs" does not exist: „relation” înseamnă tabel (sau view). Aici lipsește un e.

DETAIL: o regulă încălcată

Când o constrângere respinge datele, DETAIL îți arată exact valoarea vinovată:

\set ON_ERROR_STOP off
INSERT INTO clienti (nume, email, inscris) VALUES ('ana pop', 'ana.popescu@exemplu.ro', '2025-03-14');
INSERT INTO produse (nume, categorie_id, pret) VALUES ('Husă telefon', 9, 30);
ERROR:  duplicate key value violates unique constraint "clienti_email_key"
DETAIL:  Key (email)=(ana.popescu@exemplu.ro) already exists.
ERROR:  insert or update on table "produse" violates foreign key constraint "produse_categorie_id_fkey"
DETAIL:  Key (categorie_id)=(9) is not present in table "categorii".
  • Prima eroare: adresa de email este deja folosită, iar coloana email este UNIQUE (constrângerea clienti_email_key).
  • A doua: categoria 9 nu există în tabelul categorii, deci cheia străină produse_categorie_id_fkey respinge produsul.

Codurile SQLSTATE

Fiecare eroare are și un cod de 5 caractere, numit SQLSTATE. Aplicațiile nu compară textul mesajului (care se poate schimba), ci codul. De exemplu, o aplicație Spring sau Node.js prinde codul 23505 și îi arată utilizatorului „Există deja un cont cu acest email”.

CodNumeleCând apare
23505unique_violationo valoare duplicată într-o coloană UNIQUE sau PRIMARY KEY
23503foreign_key_violationo cheie străină spre un rând care nu există
23502not_null_violationlipsește o valoare obligatorie
22P02invalid_text_representationun text care nu poate deveni tipul cerut
42P01undefined_tabletabel inexistent
42703undefined_columncoloană inexistentă
42601syntax_erroro greșeală de scriere în SQL
Caută codul, nu mesajul

Când nu înțelegi o eroare, caută pe Google codul împreună cu „postgresql” (de exemplu postgresql 23503). Vei găsi documentația oficială și răspunsuri pe Stack Overflow pentru exact situația ta.

Greșeli care se ascund

Unele greșeli dau eroare imediat, altele nu. Cea mai perfidă: o virgulă lipsă între două coloane. SELECT nume pret nu dă eroare, ci afișează coloana nume sub numele pret (al doilea cuvânt devine alias):

SELECT nume pret FROM produse WHERE id = 1;
      pret
----------------
 Laptop Nova 14
(1 rând)

Cu un nume de tabel în față (p.nume p.pret), aceeași virgulă lipsă dă syntax error at or near ".". Iar un text între ghilimele duble ("Accesorii") dă column "Accesorii" does not exist, cum ai văzut în lecția trecută.

1
Citește rândul ERROR până la capăt.
2
Uită-te unde arată ^ și la rândul LINE.
3
Citește DETAIL și HINT, dacă există.
4
Repară o singură greșeală, rulează din nou și treci la următoarea.

Rezumat

1ERROR + LINE

Ce s-a întâmplat și unde; ^ arată locul exact.

2DETAIL + HINT

Valoarea vinovată și o sugestie de reparație.

3SQLSTATE

Codul pe care îl verifică aplicațiile: 23505, 23503, 22P02, 42P01.

4Pe rând

Repari prima eroare, rulezi, apoi treci la următoarea.

Exercițiul tău

Un coleg ți-a trimis o interogare care ar trebui să afișeze accesoriile mai ieftine de 120 de lei, cu numele, prețul și stocul. Interogarea are trei greșeli. Rulează-o, citește fiecare eroare și repar-o.

  • Rulează scriptul și citește prima eroare (de unde vine semnul ^?).
  • Repară pe rând: o virgulă lipsă, o coloană scrisă greșit și un text scris între ghilimele duble.
  • Rezultatul final: numele, prețul și stocul accesoriilor sub 120 de lei, ordonate după preț.
Între p.nume și p.pret lipsește o virgulă; coloana de stoc se numește stoc; textele se scriu între apostrofuri: 'Accesorii'.

Soluția exercițiului

SELECT p.nume, p.pret, p.stoc
FROM produse p
JOIN categorii c ON c.id = p.categorie_id
WHERE c.nume = 'Accesorii' AND p.pret < 120
ORDER BY p.pret;
Excelent! Continuă cu lecția următoare →
script.sqlPostgreSQL
ConsolăSe încarcă...
Mediul de lucru se încarcă. Poți citi lecția între timp.
Rulează codul cu butonul de sus sau cu Ctrl + Enter / Cmd + Enter.
Parcursul tău Primii pași cu PostgreSQL Lecția 9 · Cum citești o eroare PostgreSQL
Progres 0% 0 din 12
Lecția curentă 9 / 10 Introducere