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

ERROR: cannot extract elements from an object

Pe scurt

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ă

Greșit
SQL
SELECT l->>'sku' FROM comenzi_json, jsonb_array_elements(doc->'linii') l;
Corect
SQL
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

Greșit
SQL
SELECT * FROM jsonb_array_elements('{"a": 1, "b": 2}');
Corect
SQL
SELECT * FROM jsonb_each('{"a": 1, "b": 2}');

Pentru obiecte, jsonb_each întoarce perechi cheie–valoare.

3jsonpath lax

Greșit
SQL
SELECT jsonb_array_elements(doc->'linii') FROM comenzi_json;
Corect
SQL
SELECT jsonb_path_query(doc, '$.linii[*]') FROM comenzi_json;

În modul lax, un obiect e tratat ca array cu un element.

Repară tu

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.

Codul care dă eroarea
SQL
SELECT c.id, l->>'sku' AS sku
FROM comenzi_json c,
     jsonb_array_elements(c.doc->'linii') l
ORDER BY c.id, sku;
După reparație, programul afișează
 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

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 CHECK pe 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

← 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.