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ând | Ce îț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;
^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”.
| Cod | Numele | Când apare |
|---|---|---|
| 23505 | unique_violation | o valoare duplicată într-o coloană UNIQUE sau PRIMARY KEY |
| 23503 | foreign_key_violation | o cheie străină spre un rând care nu există |
| 23502 | not_null_violation | lipsește o valoare obligatorie |
| 22P02 | invalid_text_representation | un text care nu poate deveni tipul cerut |
| 42P01 | undefined_table | tabel inexistent |
| 42703 | undefined_column | coloană inexistentă |
| 42601 | syntax_error | o greșeală de scriere în SQL |
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ă.
Rezumat
Ce s-a întâmplat și unde; ^ arată locul exact.
Valoarea vinovată și o sugestie de reparație.
Codul pe care îl verifică aplicațiile: 23505, 23503, 22P02, 42P01.
Repari prima eroare, rulezi, apoi treci la următoarea.
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ț.
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;
