OBJECTTOARRAY- Cosmos DB 中的查询语言(Azure 和 Fabric)

该 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

为了提高查询性能和更简单的筛选,尽可能将变量属性建模为数组,而不是使用动态对象键。 数组比动态枚举的对象属性更易于直接编制索引和筛选。