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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
jsonb_array_length funcționează doar pe array-uri JSON. Dacă valoarea este un obiect ({...}), un text sau un număr, dă această eroare; pentru NULL (cheie lipsă) întoarce NULL. O singură valoare cu formă diferită oprește toată interogarea, deci problema apare de obicei în date reale, venite din surse diferite sau din versiuni vechi ale aplicației.
jsonb_typeof(valoare) întoarce object, array, string, number, boolean sau null, deci poți trata cazurile explicit: CASE jsonb_typeof(doc->'linii') WHEN 'array' THEN jsonb_array_length(doc->'linii') WHEN 'object' THEN 1 ELSE 0 END. Pe termen lung e mai bine să normalizezi documentele (un obiect singur devine un array cu un element) și să validezi structura la scriere, de exemplu cu o constrângere CHECK (jsonb_typeof(doc->'linii') = 'array').
De ce apare: cauzele frecvente
1Documente cu structură amestecată
SELECT jsonb_array_length(doc->'linii') FROM comenzi_json;SELECT CASE jsonb_typeof(doc->'linii') WHEN 'array' THEN jsonb_array_length(doc->'linii') ELSE 1 END
FROM comenzi_json;Valorile care nu sunt array sunt tratate separat.
2Normalizare permanentă
-- linii stocate uneori ca obiectUPDATE comenzi_json SET doc = jsonb_set(doc, '{linii}', jsonb_build_array(doc->'linii'))
WHERE jsonb_typeof(doc->'linii') = 'object';După normalizare, toate documentele au array-ul așteptat.
Repară eroarea, direct în pagină
Raportul numără liniile din fiecare comandă cu jsonb_array_length, dar comanda 3 are linia stocată ca obiect, nu ca array, și apare cannot get array length of a non-array. Folosește jsonb_typeof ca obiectele să conteze ca o linie și afișează id-ul și numărul de linii.
SELECT id, jsonb_array_length(doc->'linii') AS nr_linii
FROM comenzi_json
ORDER BY id;id | nr_linii ----+---------- 1 | 2 2 | 1 3 | 1 (3 rânduri)
Indiciu
CASE jsonb_typeof(doc->'linii') WHEN 'array' THEN ... ELSE 1 END
Reparația
SELECT id,
CASE jsonb_typeof(doc->'linii')
WHEN 'array' THEN jsonb_array_length(doc->'linii')
ELSE 1
END AS nr_linii
FROM comenzi_json
ORDER BY id;De ce merge
jsonb_typeof spune forma valorii înainte să o folosești. Pentru array-uri se calculează lungimea reală (2 și 1), iar pentru obiectul din comanda 3 se întoarce 1, pentru că reprezintă o singură linie. Interogarea nu mai cade pe documentele cu structură diferită.
Alte forme ale mesajului
ERROR: cannot get array length of a scalar
Cum o eviți pe viitor
- Validează structura documentelor la scriere, cu
CHECKpejsonb_typeofsau cu validare în aplicație. - Normalizează datele vechi după ce schimbi formatul documentelor.
- Folosește
jsonb_typeofîn rapoarte care trebuie să reziste la date neuniforme. - Documentează schema JSON așteptată, chiar dacă baza de date nu o impune.
Întrebări frecvente
Ce întoarce jsonb_array_length pe o cheie lipsă?
NULL. Eroarea apare doar pe valori existente care nu sunt array-uri.
Există un echivalent fără erori?
Expresiile jsonpath în modul lax, de exemplu jsonb_path_query_array(doc, '$.linii[*]'), tratează un obiect singur ca un array cu un element.
Erori înrudite
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. 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: JSON object does not contain key "oras" O expresie jsonpath în modul strict a cerut o cheie care lipsește dintr-un document. În modul strict, structura trebuie să existe exact. Folosește modul lax (implicit, fără cuvântul strict), care sare peste cheile lipsă, sau adaugă un filtru care verifică existența. Î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.
