jsonb_array_length() and json_array_length()
AttentionThis page documents an earlier version. Go to the latest (v2.3) version.
Purpose: Return the count of values (primitive or compound) in the array. You can use this to iterate over the elements of a JSON array using the
Signature For the
input value: jsonb return value: integer
Notes: Each function in this pair requires that the supplied JSON value is an array.
do $body$ declare j constant jsonb := '["a", 42, true, null]'; last_idx constant int := (jsonb_array_length(j) - 1); expected_typeof constant text := array['string', 'number', 'boolean', 'null']; begin for n in 0..last_idx loop assert jsonb_typeof(j -> n) = expected_typeof[n + 1], 'unexpected'; end loop; end; $body$;
This example uses the
Reading the values themselves would need to use a
case statement that tests the emergent JSON data type and that selects the leg whose assignment target has the right SQL data type. This is straightforward only for primitive JSON values. If a compound JSON value is encountered, then it must be decomposed, recursively, until the ultimate JSON primitive value leaves are reached.
This complexity reflects the underlying impedance mismatch between JSON's type system and SQL's type system. Introspecting a JSON value when you have no a priori understanding of its structure is tricky.