...
Eroare SQL · INSERT, UPDATE și tipuri de date

string or blob too big

Pe scurt

O valoare text sau BLOB a depășit lungimea maximă permisă de SQLite (implicit 1 miliard de octeți). De obicei e o greșeală de calcul (dimensiune în octeți în loc de KB) sau un text care crește fără limită. Verifică dimensiunea înainte să creezi valoarea.

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

Ce înseamnă

SQLite are o limită pentru mărimea unei singure valori text sau BLOB, SQLITE_LIMIT_LENGTH, implicit 1 000 000 000 de octeți. Orice operație care ar produce o valoare mai mare, fie că e zeroblob, randomblob, ||, replace, printf, group_concat sau un INSERT, se oprește cu string or blob too big.

În practică apare când:

  • calculezi greșit o dimensiune (înmulțești de două ori cu 1024);
  • un group_concat sau un CTE recursiv lipește text fără condiție de oprire;
  • aplicația încearcă să salveze în baza de date un fișier foarte mare (video, arhivă).

Pentru fișiere mari, soluția corectă e să le ții pe disc și să salvezi în baza de date doar calea.

De ce apare: cauzele frecvente

1Unitate de măsură greșită

Greșit
SQL
-- vrem un blob de test de 2 KB
SELECT length(zeroblob(2 * 1024 * 1024 * 1024));
Corect
SQL
SELECT length(zeroblob(2 * 1024));

2 KB înseamnă 2 * 1024 octeți. Cu încă două înmulțiri ajungi la 2 GB, peste limită.

2Fișier mare salvat ca BLOB

Greșit
SQL
INSERT INTO fisiere (nume, continut)
VALUES ('curs.mp4', readfile('curs.mp4'));
Corect
SQL
INSERT INTO fisiere (nume, cale)
VALUES ('curs.mp4', '/media/cursuri/curs.mp4');

Fișierele de ordinul gigaocteților nu încap într-o valoare SQLite. Salvează calea și ține fișierul pe disc.

Repară tu

Repară eroarea, direct în pagină

Scriptul creează câte un fișier de test pentru fiecare dimensiune din teste (coloana kb, în kilobytes) și afișează dimensiunea în octeți. Formula înmulțește de prea multe ori cu 1024 și dă string or blob too big. Repar-o ca să afișeze kb și octeti (lungimea blob-ului), ordonat după kb.

Codul care dă eroarea
SQL
SELECT kb, length(zeroblob(kb * 1024 * 1024)) AS octeti
FROM teste
ORDER BY kb;
După reparație, programul afișează
kb | octeti
1 | 1024
4 | 4096
2048 | 2097152
Indiciu

Un kilobyte are 1024 de octeți, deci înmulțești o singură dată.

Cum o eviți pe viitor

Calculează dimensiunile cu unitatea scrisă explicit (2 * 1024 pentru 2 KB) și verifică rezultatul cu length() pe un exemplu mic. Pune mereu condiție de oprire în CTE-urile recursive care lipesc text. Pentru fișiere mari, salvează pe disc sau în stocare de obiecte și ține în baza de date doar calea și metadatele.

Întrebări frecvente

Pot mări limita?

Doar până la aproximativ 2 GB și doar la compilarea SQLite sau cu sqlite3_limit din aplicație. De obicei nu e o idee bună: baza devine lentă și greu de copiat.

Limita e pe rând sau pe valoare?

Limita principală e pe o singură valoare (un text sau un BLOB). Un rând poate avea mai multe coloane mari, dar fiecare trebuie să fie sub limită.

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.