OBJECTTOARRAY- Cosmos DB 中的查詢語言(在 Azure 與 Fabric 中)

此 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

為了提升查詢效能並簡化篩選,建議盡可能將模型變數屬性以陣列形式呈現,而非使用動態物件鍵。 陣列比動態列舉物件屬性更容易直接索引與篩選。