...
Eroare SQL · Agregări, GROUP BY și funcții fereastră

integer overflow

Pe scurt

SUM() sau abs() a depășit cel mai mare întreg pe 64 de biți (9223372036854775807). SUM pe coloane întregi refuză să piardă precizie și dă eroare. Folosește TOTAL(), care lucrează cu numere reale, sau verifică dacă datele chiar au valori atât de mari.

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

Ce înseamnă

SQLite stochează întregii pe 64 de biți, deci cea mai mare valoare posibilă e 9223372036854775807. Majoritatea operațiilor trec automat la numere reale când depășesc limita, dar SUM() pe valori întregi are o regulă strictă: dacă suma depășește limita, dă integer overflow în loc să întoarcă un rezultat aproximativ.

Aceeași eroare o dă abs(-9223372036854775808), pentru că valoarea pozitivă corespunzătoare nu încape.

În practică, mesajul apare când o coloană conține valori uriașe: identificatori numerici lungi, sume în unități foarte mici, timestamp-uri în nanosecunde sau date importate greșit. TOTAL() face aceeași adunare, dar întoarce mereu un număr real și nu dă eroare.

De ce apare: cauzele frecvente

1Sumă de valori foarte mari

Greșit
SQL
SELECT SUM(octeti) FROM trafic;
Corect
SQL
SELECT TOTAL(octeti) FROM trafic;

TOTAL întoarce un număr real, deci nu are limita întregilor pe 64 de biți. Pierde doar precizia ultimelor cifre.

2Date importate greșit

Greșit
SQL
-- un ID de 19 cifre importat în coloana valoare
SELECT SUM(valoare) FROM plati;
Corect
SQL
SELECT SUM(valoare) FROM plati
WHERE valoare < 1000000000;

Dacă valorile uriașe sunt de fapt greșeli de import, rezolvarea e să le cureți sau să le excluzi, nu să schimbi funcția.

Repară tu

Repară eroarea, direct în pagină

Interogarea afișează traficul total al fiecărui server (server, total), în octeți, ordonat după server. Pentru serverul s2 suma depășește limita întregilor și acum dă integer overflow. Repar-o ca să afișeze totalurile ca numere reale.

Codul care dă eroarea
SQL
SELECT server, SUM(octeti) AS total
FROM trafic
GROUP BY server
ORDER BY server;
După reparație, programul afișează
server | total
s1 | 4600
s2 | 9500000000000000000
Indiciu

Există o funcție de agregare care adună ca SUM, dar întoarce mereu număr real.

Alte forme ale mesajului

  • sqlite3.OperationalError: integer overflow
  • ERROR: bigint out of range
  • ERROR 1690 (22003): BIGINT value is out of range in 'sum(`octeti`)'

Cum o eviți pe viitor

Alege unitatea de măsură potrivită pentru volumele tale: kilobytes în loc de octeți, lei cu zecimale în loc de miimi de ban. Pentru sume care pot deveni foarte mari, folosește TOTAL() sau convertește explicit cu CAST(x AS REAL). Validează datele la import, ca o coloană numerică să nu primească identificatori lungi.

Întrebări frecvente

Care e diferența dintre SUM și TOTAL?

SUM întoarce întreg dacă toate valorile sunt întregi și NULL pe un set gol. TOTAL întoarce mereu real și 0.0 pe un set gol.

De ce 9223372036854775807 + 1 nu dă eroare?

Adunarea obișnuită trece automat la număr real. Doar SUM și abs verifică explicit depășirea și dau eroare.

Erori înrudite

← Toate erorile SQL

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ță SQL de la zero, cu exerciții la fiecare lecție

Curs SQL: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.