跳至主要內容
翻譯頁面

本頁面由英文在 AI 協助下翻譯而成。若兩者有出入,請以英文版本為準。

JSON_ARRAY_LENGTH

傳回 JSON 陣列中的元素數目。

另請參閱:
[SELECT] [DESCRIBE] [JSON_EXTRACT] [ 資料型別 ]


提示

使用 DESCRIBE 陳述式找出可搭配 StackQL JSON 函式使用的 array 或 object 資料型別。使用 JSON_TYPE 函式判斷巢狀物件或陣列元素的資料型別。

語法​

SELECT JSON_ARRAY_LENGTH(json_array_or_object [, json_path]) FROM <multipartIdentifier>;

引數​

json_array_or_object
JSON 陣列或物件。

如果 json_array_or_object 是 JSON 物件(而非陣列)且未指定 json_path,則傳回 0。

json_path
選用的 JSON 路徑,指向物件內所含的陣列。請參閱 jsonpath.com。

如果提供了 json_path,json_array_length 函式會在 json_array_or_object 中找出該路徑並傳回陣列的長度;如果 json_path 是物件(而非陣列),則傳回 0。如果在 json_array_or_object 中找不到 json_path,則傳回 NULL。

如果 json_array_or_object 不是格式正確的 JSON,或 json_path 不是格式正確的 JSON 路徑,則會擲回錯誤。

傳回值​

傳回整數。


範例​

傳回附加至 Google Compute Engine 執行個體的磁碟數目​

SELECT name, json_array_length(disks) as num_disks
FROM google.compute.instances
WHERE project = 'stackql-demo'
AND zone = 'australia-southeast1-a';

傳回附加至 Google Compute Engine 執行個體的網路介面數目​

SELECT name, json_array_length(networkInterfaces) as num_nics
FROM google.compute.instances
WHERE project = 'stackql-demo'
AND zone = 'australia-southeast1-a';

傳回與 Google Storage 儲存貯體相關聯的 ACL 數目​

SELECT name, json_array_length(acl) as num_acls
FROM google.storage.buckets
WHERE project = 'stackql';

傳回與服務帳戶相關聯的範圍數目​

SELECT name, json_array_length(serviceAccounts, '$[0].scopes') as num_scopes
FROM google.compute.instances
WHERE project = 'stackql-demo'
AND zone = 'australia-southeast1-a';

如需詳細資訊,請參閱 https://www.sqlite.org/json1.html#jarraylen