JSON_ARRAY_LENGTH 函數 - Amazon Redshift
語法引數傳回類型範例

Amazon Redshift 自 2025 年 11 月 1 日起不再支援建立新的 Python UDF。如果您想要使用 Python UDF，請在該日期之前建立 UDF。現有 Python UDF 將繼續正常運作。如需詳細資訊，請參閱部落格文章。

JSON_ARRAY_LENGTH 函數

注意

JSON_PARSE 及其相關聯的函式會將 JSON 值剖析為 SUPER，Amazon Redshift 會剖析這類值的效率比剖析 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，以便在 JSON 無效時，陳述式傳回 NULL 而非傳回錯誤，請使用下列範例。

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

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