JSON_ARRAY_LENGTH 函数
JSON_ARRAY_LENGTH 函数返回 JSON 字符串的外部数组中的元素的数量。如果 null_if_invalid 参数设置为 true
并且 JSON 字符串无效,函数将返回 NULL
而不是返回错误。
有关更多信息,请参阅JSON 函数。
语法
JSON_ARRAY_LENGTH('json_array' [, null_if_invalid ] )
参数
- json_array
-
格式正确的 JSON 数组。
- null_if_invalid
-
(可选)一个
BOOLEAN
值,指定在输入 JSON 字符串无效时是否返回NULL
,而不返回错误。要在 JSON 无效时返回NULL
,请指定true
(t
)。要在 JSON 无效时返回错误,请指定false
(f
)。默认为false
。
返回类型
INTEGER
示例
要返回数组中的元素数,请使用以下示例。
SELECT JSON_ARRAY_LENGTH('[11,12,13,{"f1":21,"f2":[25,26]},14]');
+-------------------+ | json_array_length | +-------------------+ | 5 | +-------------------+
要因为 JSON 无效而返回错误,请使用以下示例。
SELECT JSON_ARRAY_LENGTH('[11,12,13,{"f1":21,"f2":[25,26]},14');
ERROR: invalid json array object [11,12,13,{"f1":21,"f2":[25,26]},14
要将 null_if_invalid 设置为 true,以便语句返回 NULL
,而不是在 JSON 无效时返回错误,请使用以下示例。
SELECT JSON_ARRAY_LENGTH('[11,12,13,{"f1":21,"f2":[25,26]},14',true);
+-------------------+ | json_array_length | +-------------------+ | NULL | +-------------------+