从补丁 198 开始，Amazon Redshift 将不再支持创建新的 Python UDF。现有的 Python UDF 将继续正常运行至 2026 年 6 月 30 日。有关更多信息，请参阅[博客文章](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/)。

# JSON\$1ARRAY\$1LENGTH 函数
<a name="JSON_ARRAY_LENGTH"></a>

**注意**  
JSON\$1PARSE 及其关联函数将 JSON 值解析为 SUPER，Amazon Redshift 解析 SUPER 的效率比 VARCHAR 更高。  
 我们建议您使用 [JSON\$1PARSE 函数](JSON_PARSE.md)解析 JSON 字符串来获取 SUPER 值，而不是使用 JSON\$1ARRAY\$1LENGTH。然后，使用 [GET\$1ARRAY\$1LENGTH 函数](get_array_length.md)来获取数组的长度。

JSON\$1ARRAY\$1LENGTH 函数返回 JSON 字符串的外部数组中的元素的数量。如果 *null\$1if\$1invalid* 参数设置为 `true` 并且 JSON 字符串无效，函数将返回 `NULL` 而不是返回错误。

有关更多信息，请参阅 [JSON 函数](json-functions.md)。

## 语法
<a name="JSON_ARRAY_LENGTH-synopsis"></a>

```
JSON_ARRAY_LENGTH('json_array' [, null_if_invalid ] ) 
```

## 参数
<a name="JSON_ARRAY_LENGTH-arguments"></a>

 *json\$1array*  
格式正确的 JSON 数组。

 *null\$1if\$1invalid*  
（可选）一个 `BOOLEAN` 值，指定在输入 JSON 字符串无效时是否返回 `NULL`，而不返回错误。要在 JSON 无效时返回 `NULL`，请指定 `true`（`t`）。要在 JSON 无效时返回错误，请指定 `false` (`f`)。默认为 `false`。

## 返回类型
<a name="JSON_ARRAY_LENGTH-return"></a>

`INTEGER`

## 示例
<a name="JSON_ARRAY_LENGTH-examples"></a>

要返回数组中的元素数，请使用以下示例。

```
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\$1if\$1invalid* 设置为 *true*，以便语句返回 `NULL`，而不是在 JSON 无效时返回错误，请使用以下示例。

```
SELECT JSON_ARRAY_LENGTH('[11,12,13,{"f1":21,"f2":[25,26]},14',true);

+-------------------+
| json_array_length |
+-------------------+
| NULL              |
+-------------------+
```