此 OBJECTTOARRAY 函數會將 JSON 物件中的欄位/值配對轉換為 JSON 陣列。
語法
OBJECTTOARRAY(<object_expr> [, <string_expr_1>, <string_expr_2>])
Arguments
| Description | |
|---|---|
object_expr |
具有欄位/值配對中屬性的物件運算式。 |
string_expr_1 |
字串運算式,其欄位名稱代表原始欄位/值組的 欄位 部分。 |
string_expr_2 |
字串運算式,其欄位名稱代表原始欄位/值組的 值 部分。 |
傳回類型
傳回具有兩個欄位的 k 元素陣列,或 v 自訂命名欄位。
範例
本節包含如何使用此查詢語言建構的範例。
將物件轉換為陣列
在此範例中,函數 OBJECTTOARRAY 用於將 JSON 物件轉換為陣列。
SELECT VALUE
OBJECTTOARRAY({
"a": "12345",
"b": "67890"
})
[
[
{
"k": "a",
"v": "12345"
},
{
"k": "b",
"v": "67890"
}
]
]
動態屬性存取
Azure Cosmos DB 查詢語言並未提供內建函式來列舉物件屬性名稱(例如 OBJECT_KEYS)。 若要列舉未知屬性名稱,請在結果的鍵值對上使用 OBJECTTOARRAY 和 JOIN 。
{
"id": "1",
"metadata": {
"color": "blue",
"size": "small"
}
}
SELECT p.id, kv["key"] AS propertyName, kv["value"] AS propertyValue
FROM p
JOIN kv IN OBJECTTOARRAY(p.metadata, "key", "value")
此模式會為每個項目回傳每個屬性 p.metadata 一列。
[
{ "id": "1", "propertyName": "color", "propertyValue": "blue" },
{ "id": "1", "propertyName": "size", "propertyValue": "small" }
]
如果您只需要檢查某個特定屬性是否存在,請使用 IS_DEFINED。
SELECT p.id, IS_DEFINED(p.metadata["region"]) AS hasRegion
FROM p
為了提升查詢效能並簡化篩選,建議盡可能將模型變數屬性以陣列形式呈現,而非使用動態物件鍵。 陣列比動態列舉物件屬性更容易直接索引與篩選。