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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Tipul integer ocupă 4 octeți și permite valori între -2.147.483.648 și 2.147.483.647. Când rezultatul unei operații între două integer depășește acest interval, PostgreSQL nu îl trece automat la bigint, ci dă eroare. Variantele smallint out of range (±32.767) și bigint out of range urmează aceeași logică.
Cazuri frecvente: înmulțiri de tipul cantitate * pret_in_bani sau secunde * 1000 pe coloane integer; conversia unui număr mare (un CNP, un telefon) la ::int; o coloană integer care primește id-uri dintr-o secvență bigint; contoare care cresc ani la rând. Soluția este să convertești la bigint înainte de operație (cantitate::bigint * pret) sau să schimbi tipul coloanei. Numerele de telefon și CNP-urile nu sunt cantități: stochează-le ca text.
De ce apare: cauzele frecvente
1Înmulțire între două coloane integer
SELECT sum(cantitate * pret_bani) FROM vanzari;SELECT sum(cantitate::bigint * pret_bani) FROM vanzari;Conversia unui operand la bigint face toată înmulțirea în bigint.
2Număr de identificare convertit la int
SELECT '1950314123456'::int;SELECT '1950314123456'::text; -- CNP-ul se stochează ca textCodurile numerice lungi nu sunt cantități și nu încap în integer.
3Coloană id integer aproape de limită
INSERT INTO evenimente (id, ...) VALUES (2147483648, ...);ALTER TABLE evenimente ALTER COLUMN id TYPE bigint;Pentru tabele care cresc mult, cheile se declară bigint de la început.
Repară eroarea, direct în pagină
Raportul calculează valoarea vânzărilor în bani (cantitate × preț în bani), iar ambele coloane sunt integer. Interogarea dă integer out of range. Repar-o ca să afișeze produsul și valoarea totală în bani, ordonate după produs.
SELECT produs, sum(cantitate * pret_bani) AS valoare_bani
FROM vanzari
GROUP BY produs
ORDER BY produs;produs | valoare_bani --------+-------------- Laptop | 52498500000 Mouse | 5950000 (2 rânduri)
Indiciu
Fă înmulțirea într-un tip mai mare decât integer.
Reparația
SELECT produs, sum(cantitate::bigint * pret_bani) AS valoare_bani
FROM vanzari
GROUP BY produs
ORDER BY produs;De ce merge
cantitate * pret_bani are ambii operanzi integer, deci rezultatul e calculat tot ca integer, iar 150.000 × 349.990 depășește 2,1 miliarde. Cu cantitate::bigint, înmulțirea se face în bigint, care merge până la aproximativ 9,2 × 10^18, iar suma pe fiecare produs se calculează corect.
Alte forme ale mesajului
ERROR: smallint out of rangeERROR: bigint out of range
Cum o eviți pe viitor
- Folosește
bigintpentru chei primare și contoare care pot crește mult. - Convertește un operand la
bigintsaunumericînainte de înmulțiri mari. - Stochează codurile (telefon, CNP, IBAN) ca text, nu ca numere.
- Monitorizează secvențele care se apropie de limita tipului coloanei.
Întrebări frecvente
De ce sum(coloana_integer) nu dă eroarea asta?
sum pe integer întoarce bigint, deci adunarea are loc într-un tip mai mare. Înmulțirea dintre două integer rămâne însă integer.
Cât ocupă bigint față de integer?
8 octeți față de 4. Pentru majoritatea tabelelor diferența e neglijabilă comparativ cu riscul unei migrări forțate mai târziu.
Erori înrudite
ERROR: numeric field overflow 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ă. ERROR: nextval: reached maximum value of sequence "bilete_id_seq" (32767) Secvența unei coloane a ajuns la valoarea maximă: limita tipului (32767 pentru smallint, 2147483647 pentru integer) sau un MAXVALUE setat explicit. Nu se mai pot genera id-uri. Schimbă tipul coloanei și al secvenței în bigint (ALTER TABLE ... TYPE bigint, ALTER SEQUENCE ... AS bigint). 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. Î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.
