...
Eroare PostgreSQL · JSONB, array-uri și căutare full-text

ERROR: cannot call jsonb_each on a non-object

Pe scurt

jsonb_each (sau jsonb_each_text, jsonb_object_keys) a primit un array sau un scalar în loc de obiect. Fie calea indică greșit, fie valoarea e o listă. Pentru array-uri folosește jsonb_array_elements; pentru date amestecate, verifică forma cu jsonb_typeof.

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

Ce înseamnă

jsonb_each desface un obiect JSON în rânduri cu două coloane, key și value. Pe un array sau un scalar nu are chei, deci dă această eroare. Variante: cannot call jsonb_object_keys on an array, cannot call jsonb_each_text on a non-object, cannot deconstruct an array as an object la jsonb_populate_record.

Apare mai ales la documente cu atribute dinamice, de exemplu caracteristicile unui produs ({"culoare": "negru", "greutate": "1.2 kg"}), unde unele rânduri au primit un array din altă sursă ([{"nume": "culoare", ...}]). Soluțiile: filtrezi rândurile după jsonb_typeof(x) = 'object', tratezi separat array-urile sau normalizezi datele. Dacă scrii în mod regulat interogări pe chei dinamice, poate merită o tabelă separată cheie–valoare.

De ce apare: cauzele frecvente

1Array în loc de obiect

Greșit
SQL
SELECT key FROM produse_json, jsonb_each(atribute);  -- unele atribute sunt array
Corect
SQL
SELECT key FROM produse_json, jsonb_each(atribute)
WHERE jsonb_typeof(atribute) = 'object';

Funcția se aplică doar obiectelor.

2Cale greșită

Greșit
SQL
SELECT * FROM jsonb_each(doc->'linii');
Corect
SQL
SELECT * FROM jsonb_each(doc->'client');

client este obiect; linii este array.

Repară tu

Repară eroarea, direct în pagină

Tabelul produse_json are atributele produselor ca obiect JSON, dar la un produs atributele au fost salvate ca array. Lista tuturor cheilor de atribute dă cannot call jsonb_each on a non-object. Ia în calcul doar obiectele și afișează cheile distincte, sortate.

Codul care dă eroarea
SQL
SELECT DISTINCT a.key
FROM produse_json p, jsonb_each(p.atribute) a
ORDER BY a.key;
După reparație, programul afișează
    key
-----------
 culoare
 diagonala
 greutate
(3 rânduri)
Indiciu

CASE WHEN jsonb_typeof(atribute) = 'object' THEN atribute ELSE '{}' END

Alte forme ale mesajului

  • ERROR: cannot call jsonb_object_keys on an array
  • ERROR: cannot deconstruct an array as an object

Cum o eviți pe viitor

  • Verifică forma valorilor cu jsonb_typeof înainte de funcțiile specifice obiectelor sau array-urilor.
  • Uniformizează formatul atributelor dinamice la scriere.
  • Adaugă CHECK (jsonb_typeof(atribute) = 'object') pe coloanele care trebuie să fie obiecte.
  • Pentru chei interogate des, mută-le în coloane obișnuite.

Întrebări frecvente

Ce diferență e între jsonb_each și jsonb_each_text?

jsonb_each întoarce valorile ca jsonb, jsonb_each_text ca text, mai comode pentru afișare.

Pune un WHERE pe jsonb_typeof la adăpost de eroare?

De obicei da, dar ordinea evaluării nu e garantată strict. Varianta sigură este un CASE în argumentul funcției sau o subinterogare.

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.