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

ERROR: cannot get array length of a non-array

Pe scurt

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ă

Greșit
SQL
SELECT jsonb_array_length(doc->'linii') FROM comenzi_json;
Corect
SQL
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ă

Greșit
SQL
-- linii stocate uneori ca obiect
Corect
SQL
UPDATE 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ă tu

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.

Codul care dă eroarea
SQL
SELECT id, jsonb_array_length(doc->'linii') AS nr_linii
FROM comenzi_json
ORDER BY id;
După reparație, programul afișează
 id | nr_linii
----+----------
  1 |        2
  2 |        1
  3 |        1
(3 rânduri)
Indiciu

CASE jsonb_typeof(doc->'linii') WHEN 'array' THEN ... ELSE 1 END

Alte forme ale mesajului

  • ERROR: cannot get array length of a scalar

Cum o eviți pe viitor

  • Validează structura documentelor la scriere, cu CHECK pe jsonb_typeof sau 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

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