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

ERROR: integer out of range

Pe scurt

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

Greșit
SQL
SELECT sum(cantitate * pret_bani) FROM vanzari;
Corect
SQL
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

Greșit
SQL
SELECT '1950314123456'::int;
Corect
SQL
SELECT '1950314123456'::text;  -- CNP-ul se stochează ca text

Codurile numerice lungi nu sunt cantități și nu încap în integer.

3Coloană id integer aproape de limită

Greșit
SQL
INSERT INTO evenimente (id, ...) VALUES (2147483648, ...);
Corect
SQL
ALTER TABLE evenimente ALTER COLUMN id TYPE bigint;

Pentru tabele care cresc mult, cheile se declară bigint de la început.

Repară tu

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.

Codul care dă eroarea
SQL
SELECT produs, sum(cantitate * pret_bani) AS valoare_bani
FROM vanzari
GROUP BY produs
ORDER BY produs;
După reparație, programul afișează
 produs | valoare_bani
--------+--------------
 Laptop |  52498500000
 Mouse  |      5950000
(2 rânduri)
Indiciu

Fă înmulțirea într-un tip mai mare decât integer.

Alte forme ale mesajului

  • ERROR: smallint out of range
  • ERROR: bigint out of range

Cum o eviți pe viitor

  • Folosește bigint pentru chei primare și contoare care pot crește mult.
  • Convertește un operand la bigint sau numeric î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

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