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

ERROR: numeric field overflow

Pe scurt

Valoarea nu încape în precizia coloanei numeric(p, s): numeric(5,2) acceptă cel mult 999.99. Mesajul vine cu DETAIL: A field with precision 5, scale 2 must round to an absolute value less than 10^3. Mărește precizia coloanei sau verifică dacă valoarea e corectă.

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

Ce înseamnă

La numeric(p, s), p este numărul total de cifre, iar s numărul de zecimale. Rămân p - s cifre pentru partea întreagă: numeric(5,2) permite valori sub 1000. O valoare mai mare dă această eroare, cu DETAIL-ul care explică limita (de exemplu must round to an absolute value less than 10^3).

Valorile cu mai multe zecimale decât s nu dau eroare, ci sunt rotunjite. Cauze tipice: o coloană proiectată pentru prețuri mici primește prețuri mari, un calcul (preț × cantitate, conversie valutară) depășește limita, sau o valoare greșită (în bani în loc de lei, de 100 de ori mai mare). Mărirea preciziei (ALTER COLUMN ... TYPE numeric(12,2)) rescrie tabelul, deci pe tabele mari e o operație de planificat.

De ce apare: cauzele frecvente

1Precizie prea mică

Greșit
SQL
CREATE TABLE preturi (valoare numeric(5,2));
INSERT INTO preturi VALUES (3499.90);
Corect
SQL
CREATE TABLE preturi (valoare numeric(10,2));
INSERT INTO preturi VALUES (3499.90);

Cu 10 cifre în total și 2 zecimale încap valori până la 99.999.999,99.

2Calcul care depășește limita

Greșit
SQL
UPDATE linii SET valoare = pret * cantitate;  -- valoare numeric(6,2)
Corect
SQL
ALTER TABLE linii ALTER COLUMN valoare TYPE numeric(12,2);
UPDATE linii SET valoare = pret * cantitate;

Rezultatul unei înmulțiri poate fi mult mai mare decât operanzii.

3Valoare în unitatea greșită

Greșit
SQL
INSERT INTO preturi VALUES (349990);  -- bani, nu lei
Corect
SQL
INSERT INTO preturi VALUES (3499.90);

Uneori limita prinde o greșeală reală de date.

Repară tu

Repară eroarea, direct în pagină

Tabelul oferte are coloana pret numeric(5,2). Adăugarea unei oferte de 3499.90 lei dă numeric field overflow. Mărește precizia coloanei la numeric(10,2), apoi inserează oferta și afișează produsul și prețul tuturor ofertelor, ordonate după preț.

Codul care dă eroarea
SQL
INSERT INTO oferte VALUES ('Laptop', 3499.90);
SELECT produs, pret FROM oferte ORDER BY pret;
După reparație, programul afișează
ALTER TABLE
INSERT 0 1
 produs |  pret
--------+---------
 Mouse  |   59.50
 Laptop | 3499.90
(2 rânduri)
Indiciu

numeric(5,2) acceptă doar trei cifre înainte de virgulă.

Cum o eviți pe viitor

  • Alege precizia cu rezervă: numeric(12,2) pentru sume în lei e o alegere uzuală.
  • Pentru calcule intermediare, folosește numeric fără limite și aplică precizia doar la stocare.
  • Validează unitățile de măsură la importuri (lei față de bani, cenți).
  • Testează valorile extreme ale datelor reale înainte de a fixa precizia.

Întrebări frecvente

De ce 12.345 nu dă eroare în numeric(5,2)?

Zecimalele în plus sunt rotunjite (12.35). Eroarea apare doar când partea întreagă nu încape.

numeric fără precizie are limite?

Practic nu: până la 131.072 de cifre înainte de virgulă. E potrivit pentru calcule; pentru stocare, precizia explicită documentează datele.

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.