Amazon Redshift 將不再支援從修補程式 198 開始建立新的 Python UDFs。現有 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 會剖析這類值的效率比剖析 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*，以便在 JSON 無效時，陳述式傳回 `NULL` 而非傳回錯誤，請使用下列範例。

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

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