JSON_ARRAY_LENGTH 函数

注意

JSON_PARSE 及其关联函数将 JSON 值解析为 SUPER，Amazon Redshift 解析 SUPER 的效率比 VARCHAR 更高。

我们建议您使用 JSON_PARSE 函数解析 JSON 字符串来获取 SUPER 值，而不是使用 JSON_ARRAY_LENGTH。然后，使用 get_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              |
+-------------------+