...
Eroare PostgreSQL · Tipuri de date, operatori și conversii

ERROR: division by zero

Pe scurt

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

Greșit
SQL
SELECT zi, comenzi / vizite AS rata FROM trafic;
Corect
SQL
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

Greșit
SQL
SELECT round(100.0 * vandut / stoc_initial, 1) FROM produse_lansare;
Corect
SQL
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

Greșit
SQL
SELECT suma / numar FROM statistici;
Corect
SQL
SELECT CASE WHEN numar = 0 THEN NULL ELSE suma / numar END FROM statistici;

CASE face același lucru ca nullif, mai explicit.

Repară tu

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.

Codul care dă eroarea
SQL
SELECT zi, round(comenzi::numeric / vizite, 3) AS rata
FROM trafic
ORDER BY zi;
După reparație, programul afișează
     zi     | rata
------------+-------
 2025-03-01 | 0.030
 2025-03-02 |  NULL
 2025-03-03 | 0.020
(3 rânduri)
Indiciu

nullif(vizite, 0)

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

← 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.