该 OBJECTTOARRAY 函数将 JSON 对象中的字段/值对转换为 JSON 数组。
Syntax
OBJECTTOARRAY(<object_expr> [, <string_expr_1>, <string_expr_2>])
Arguments
| Description | |
|---|---|
object_expr |
一个对象表达式,其中包含字段/值对中的属性。 |
string_expr_1 |
一个字符串表达式,其名称表示原始字段/值对的 字段 部分。 |
string_expr_2 |
一个字符串表达式,其名称表示原始字段/ 值对的值 部分。 |
返回类型
返回包含两个字段或kv自定义命名字段的元素数组。
例子
本部分包含有关如何使用此查询语言构造的示例。
将对象转换为数组
在此示例中,该 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
为了提高查询性能和更简单的筛选,尽可能将变量属性建模为数组,而不是使用动态对象键。 数组比动态枚举的对象属性更易于直接编制索引和筛选。