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，以便在 JSON 無效時，陳述式傳回 NULL 而非傳回錯誤，請使用下列範例。

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

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