ERROR: division by zero
O împărțire are la numitor zero, de obicei într-un raport (comenzi / vizite) pentru o zi fără vizite sau un procent dintr-un total zero. Protejează numitorul cu NULLIF(numitor, 0): rezultatul devine NULL în loc de eroare, iar cu coalesce îl poți afișa ca 0.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
PostgreSQL aruncă eroare la împărțirea la zero, atât pentru numere întregi, cât și pentru numeric (pentru double precision la fel). O singură împărțire la zero oprește toată interogarea, chiar dacă ar fi afectat un singur rând din milioane.
Soluția idiomatică este x / nullif(y, 0): când y e zero, nullif întoarce NULL, iar x / NULL este NULL, fără eroare. Apoi decizi cum afișezi lipsa valorii: coalesce(..., 0) sau lași NULL (care înseamnă corect „nu se poate calcula”). Un CASE WHEN y = 0 THEN ... ELSE x / y END funcționează la fel. Atenție și la împărțirea între întregi: 5 / 2 dă 2, deci pentru procente convertește un operand la numeric.
De ce apare: cauzele frecvente
1Rată de conversie pe zile fără vizite
SELECT zi, comenzi / vizite AS rata FROM trafic;SELECT zi, comenzi::numeric / nullif(vizite, 0) AS rata FROM trafic;nullif transformă zero în NULL, iar conversia la numeric evită trunchierea împărțirii între întregi.
2Procent dintr-un total care poate fi zero
SELECT round(100.0 * vandut / stoc_initial, 1) FROM produse_lansare;SELECT round(100.0 * vandut / nullif(stoc_initial, 0), 1) FROM produse_lansare;Produsele fără stoc inițial primesc NULL în loc să oprească raportul.
3Medie calculată manual
SELECT suma / numar FROM statistici;SELECT CASE WHEN numar = 0 THEN NULL ELSE suma / numar END FROM statistici;CASE face același lucru ca nullif, mai explicit.
Repară eroarea, direct în pagină
Raportul de trafic calculează rata de conversie (comenzi împărțit la vizite) pe fiecare zi, dar dă division by zero, pentru că într-o zi site-ul nu a avut vizite. Repar-o ca rata să fie NULL în acea zi și rotunjită la 3 zecimale în rest, cu zilele în ordine.
SELECT zi, round(comenzi::numeric / vizite, 3) AS rata
FROM trafic
ORDER BY zi;zi | rata ------------+------- 2025-03-01 | 0.030 2025-03-02 | NULL 2025-03-03 | 0.020 (3 rânduri)
Indiciu
nullif(vizite, 0)
Reparația
SELECT zi, round(comenzi::numeric / nullif(vizite, 0), 3) AS rata
FROM trafic
ORDER BY zi;De ce merge
nullif(vizite, 0) întoarce NULL când vizitele sunt zero, iar împărțirea la NULL dă NULL în loc de eroare. Conversia comenzi::numeric evită împărțirea între întregi, care ar fi dat 0. Ziua de 2 martie apare cu rata NULL, iar celelalte cu valori reale, rotunjite.
Cum o eviți pe viitor
- Protejează orice numitor care poate fi zero cu
nullif(numitor, 0). - Folosește funcțiile agregate (
avg) când e posibil; ele ignoră NULL-urile și nu împart la zero. - Decide explicit cum afișezi rezultatul lipsă (NULL, 0 sau un text) și documentează alegerea.
- Testează rapoartele pe date cu zile goale și produse fără vânzări.
Întrebări frecvente
De ce WHERE vizite > 0 nu m-a protejat?
PostgreSQL nu garantează ordinea evaluării condițiilor și expresiilor, iar în unele planuri împărțirea poate fi calculată înainte de filtrare. nullif sau CASE în expresia însăși sunt sigure.
Cum prind eroarea într-o funcție PL/pgSQL?
Cu EXCEPTION WHEN division_by_zero THEN .... În interogări obișnuite, varianta preventivă cu nullif e mai bună.
Erori înrudite
ERROR: integer out of range Un calcul sau o valoare depășește limitele tipului integer (aproximativ ±2,1 miliarde). Apare la sume mari (sum pe integer întoarce bigint, dar înmulțirea a două integer nu), la conversii (valoare::int) sau la coloane id care au ajuns la limită. Folosește bigint sau numeric pentru valori mari. ERROR: function round(double precision, integer) does not exist round(valoare, zecimale) există în PostgreSQL doar pentru numeric. Valoarea ta e double precision (float8), de exemplu rezultatul lui avg pe o coloană real, al unei împărțiri între float-uri sau al lui extract. Convertește la numeric: round(valoare::numeric, 2). ERROR: invalid input syntax for type numeric: "12,50" PostgreSQL acceptă în numeric doar punctul ca separator zecimal, fără separatoare de mii sau simboluri de monedă. Textul "12,50" (format românesc) nu poate fi convertit. Înlocuiește virgula cu punct (replace(valoare, ',', '.')) sau folosește to_number cu un format potrivit. Î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.
