...
Eroare SQL · Funcții JSON și text

JSON cannot hold BLOB values

Pe scurt

Ai pus o valoare BLOB (date binare, de exemplu din randomblob sau x'...') într-o funcție care construiește JSON (json_set, json_insert, json_object). JSON poate conține doar text, numere, true/false și null. Transformă BLOB-ul în text, de obicei cu hex().

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

Ce înseamnă

Funcțiile JSON din SQLite construiesc text JSON. JSON are doar câteva tipuri: șiruri, numere, true/false, null, obiecte și tablouri. Un BLOB e o secvență de octeți fără tip, care nu are o reprezentare în JSON, așa că json_set('{}', '$.poza', x'89504E47') dă JSON cannot hold BLOB values.

BLOB-urile apar mai des decât crezi: coloane cu imagini sau fișiere, randomblob(), hash-uri salvate binar, valori citite din alte aplicații ca bytes.

Soluția e să alegi o reprezentare text: hex(coloana) (simplu, de două ori mai lung) sau base64 calculat în aplicație. Dacă BLOB-ul conține de fapt text (de exemplu UTF-8 salvat ca bytes), CAST(coloana AS TEXT) îl transformă înapoi.

De ce apare: cauzele frecvente

1Hash binar pus în JSON

Greșit
SQL
SELECT json_set('{}', '$.hash', hash) FROM fisiere;
Corect
SQL
SELECT json_set('{}', '$.hash', lower(hex(hash))) FROM fisiere;

hex transformă octeții în text hexazecimal, pe care JSON îl poate păstra ca șir.

2Text salvat ca BLOB

Greșit
SQL
SELECT json_insert('{}', '$.nume', CAST('Ana' AS BLOB));
Corect
SQL
SELECT json_insert('{}', '$.nume', CAST(CAST('Ana' AS BLOB) AS TEXT));

Dacă octeții sunt text UTF-8, CAST(... AS TEXT) îi readuce la tipul text.

Repară tu

Repară eroarea, direct în pagină

Vrei să construiești pentru fiecare fișier un obiect JSON cu numele și hash-ul lui (info), ordonat după id. Hash-ul e salvat binar (BLOB), iar json_set dă JSON cannot hold BLOB values. Repară interogarea ca hash-ul să apară în JSON ca text hexazecimal cu litere mici.

Codul care dă eroarea
SQL
SELECT json_set(json_object('nume', nume), '$.hash', hash) AS info
FROM fisiere
ORDER BY id;
După reparație, programul afișează
info
{"nume":"factura.pdf","hash":"a1b2c3"}
{"nume":"poza.jpg","hash":"0f1e2d"}
Indiciu

hex() transformă un BLOB în text.

Alte forme ale mesajului

  • sqlite3.OperationalError: JSON cannot hold BLOB values

Cum o eviți pe viitor

Verifică tipul coloanelor pe care le pui în JSON cu typeof(coloana). Pentru date binare, alege de la început o reprezentare text (hex sau base64) și folosește-o peste tot. Nu salva imagini sau fișiere mari în JSON; ține în JSON doar calea sau un identificator.

Întrebări frecvente

De ce json_object cu un BLOB mie mi-a mers?

Versiunile noi de SQLite (3.45+) au și formatul binar JSONB, iar unele funcții tratează anumite BLOB-uri ca JSONB. Nu te baza pe asta pentru date binare oarecare; transformă-le explicit în text.

Cum aflu dacă o valoare e BLOB?

Cu typeof(valoare), care întoarce 'blob', 'text', 'integer', 'real' sau 'null'.

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.