ERROR: cannot extract elements from an object
jsonb_array_elements (sau jsonb_array_elements_text) a primit un obiect JSON, nu un array. Fie calea indică greșit (ai uitat un nivel), fie documentele au structuri diferite. Verifică valoarea cu jsonb_typeof sau folosește jsonb_each pentru perechile unui obiect.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
jsonb_array_elements(x) desface un array într-un rând pentru fiecare element. Pe un obiect dă această eroare, iar pe un scalar dă cannot extract elements from a scalar. Eroarea apare la prima valoare greșită, deci o singură comandă stocată altfel oprește tot raportul.
Pentru obiecte, funcția corectă este jsonb_each (perechi cheie–valoare) sau jsonb_object_keys. Dacă unele documente au un obiect unde altele au un array, poți filtra (WHERE jsonb_typeof(doc->'linii') = 'array') sau normaliza în interogare: CASE WHEN jsonb_typeof(x) = 'array' THEN x ELSE jsonb_build_array(x) END, care transformă un obiect singur într-un array cu un element. Jsonpath în modul lax face același lucru automat: jsonb_path_query(doc, '$.linii[*]').
De ce apare: cauzele frecvente
1Structură amestecată
SELECT l->>'sku' FROM comenzi_json, jsonb_array_elements(doc->'linii') l;SELECT l->>'sku' FROM comenzi_json,
jsonb_array_elements(CASE WHEN jsonb_typeof(doc->'linii') = 'array' THEN doc->'linii' ELSE jsonb_build_array(doc->'linii') END) l;Obiectul singur devine un array cu un element.
2Obiect parcurs ca array
SELECT * FROM jsonb_array_elements('{"a": 1, "b": 2}');SELECT * FROM jsonb_each('{"a": 1, "b": 2}');Pentru obiecte, jsonb_each întoarce perechi cheie–valoare.
3jsonpath lax
SELECT jsonb_array_elements(doc->'linii') FROM comenzi_json;SELECT jsonb_path_query(doc, '$.linii[*]') FROM comenzi_json;În modul lax, un obiect e tratat ca array cu un element.
Repară eroarea, direct în pagină
Raportul listează toate codurile sku vândute, desfăcând liniile comenzilor, dar comanda 3 are linia ca obiect și apare cannot extract elements from an object. Normalizează valoarea într-un array înainte de jsonb_array_elements și afișează id-ul comenzii și sku-ul, ordonate după id și sku.
SELECT c.id, l->>'sku' AS sku
FROM comenzi_json c,
jsonb_array_elements(c.doc->'linii') l
ORDER BY c.id, sku;id | sku ----+------- 1 | LP-01 1 | MS-01 2 | TS-01 3 | MN-27 (4 rânduri)
Indiciu
CASE WHEN jsonb_typeof(doc->'linii') = 'array' THEN doc->'linii' ELSE jsonb_build_array(doc->'linii') END
Reparația
SELECT c.id, l->>'sku' AS sku
FROM comenzi_json c,
jsonb_array_elements(
CASE WHEN jsonb_typeof(c.doc->'linii') = 'array' THEN c.doc->'linii'
ELSE jsonb_build_array(c.doc->'linii') END
) l
ORDER BY c.id, sku;De ce merge
Pentru comenzile 1 și 2, linii este deja un array și rămâne neschimbat. Pentru comanda 3, jsonb_build_array transformă obiectul într-un array cu un singur element, deci jsonb_array_elements funcționează pe toate rândurile. Rezultatul are patru coduri sku, inclusiv MN-27 din comanda 3.
Alte forme ale mesajului
ERROR: cannot extract elements from a scalar
Cum o eviți pe viitor
- Păstrează o structură uniformă a documentelor (listele sunt mereu array-uri, chiar cu un element).
- Verifică forma valorilor cu
jsonb_typeofîn rapoartele pe date istorice. - Folosește jsonpath pentru interogări tolerante la variații de structură.
- Adaugă constrângeri
CHECKpe forma câmpurilor importante.
Întrebări frecvente
Ce face jsonb_build_array(x)?
Construiește un array JSON cu valorile primite; cu un obiect, dă [{...}].
Sunt elementele întoarse în ordine?
Da, jsonb_array_elements păstrează ordinea din array; WITH ORDINALITY adaugă și poziția.
Erori înrudite
ERROR: cannot get array length of a non-array jsonb_array_length a primit un obiect sau un scalar în loc de array, de obicei pentru că documentele nu au toate aceeași structură (o comandă cu o singură linie stocată ca obiect, nu ca listă). Verifică tipul cu jsonb_typeof înainte sau normalizează documentele. ERROR: cannot call jsonb_each on a non-object 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. ERROR: set-returning functions are not allowed in WHERE Ai folosit în WHERE o funcție care întoarce mai multe rânduri (unnest, generate_series, jsonb_array_elements, regexp_matches). O condiție are nevoie de o singură valoare pe rând. Pentru căutarea într-un array, folosește = ANY(array) sau @>; pentru elementele unui JSON, @> sau EXISTS cu funcția în FROM. Î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.
