跳至主要內容
翻譯頁面

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

JSON_EXTRACT

從格式正確的 JSON 物件或陣列中傳回一或多個值。

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


提示

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

備註

如果您搭配 postgres SQL 後端使用 stackql,json_extract 函式會實作為 json_extract_path_text 函式

語法​

SELECT JSON_EXTRACT(json_array_or_object, json_path[, json_path1, .. json_pathN])
FROM <multipartIdentifier>;

引數​

json_array_or_object
JSON 陣列或物件。

json_path
指向 json_array_or_object 內所含之陣列或物件的 JSON 路徑。請參閱 jsonpath.com。

如果只提供一個 json_path,則會傳回純量結果,其資料型別對應所解析路徑的資料型別。

如果提供多個 json_path 引數,結果會是由各路徑所解析之物件組成的陣列。

為 json_path 引數指定 '$' 會傳回 json_array_or_object 引數所代表之資料行對應的整個 JSON 物件。

注意:您可以使用 json-viewer 之類的工具來開發和測試 JSON Path 運算式

傳回值​

字串、整數、物件、陣列、布林值或 null,視輸入的 json_array_or_object 與 json_path 而定。


範例​

傳回與每個 Google Compute Engine 執行個體相關聯的磁碟物件​

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

傳回每個 Google Compute Engine 執行個體所附加之第一個磁碟的裝置名稱與大小​

SELECT name, json_extract(disks, '$[0].deviceName') as device_name,
json_extract(disks, '$[0].diskSizeGb') as disk_size
FROM google.compute.instances
WHERE project = 'stackql-demo'
AND zone = 'australia-southeast1-a';

傳回每個 Google Compute Engine 執行個體所附加之第一個 NIC 的網路層級​

SELECT name, json_extract(networkInterfaces, '$[0].accessConfigs[0].networkTier') as network_tier
FROM google.compute.instances
WHERE project = 'stackql-demo'
AND zone = 'australia-southeast1-a';

傳回與每個 Google Compute Engine 執行個體相關聯之第一個服務帳戶的範圍清單​

SELECT name, json_extract(serviceAccounts, '$[0].scopes') as scopes
FROM google.compute.instances
WHERE project = 'stackql-demo'
AND zone = 'australia-southeast1-a';
/* returns a list for each service account */

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