OBJECTTOARRAY- Linguaggio di query in Cosmos DB (in Azure e Fabric)

La OBJECTTOARRAY funzione converte coppie campo/valore in un oggetto JSON in una matrice JSON.

Sintassi

OBJECTTOARRAY(<object_expr> [, <string_expr_1>, <string_expr_2>])

Arguments

Description
object_expr Espressione oggetto con proprietà nelle coppie campo/valore.
string_expr_1 Espressione stringa con un nome per il campo che rappresenta la parte del campo della coppia campo/valore originale.
string_expr_2 Espressione stringa con un nome per il campo che rappresenta la parte del valore della coppia campo/valore originale.

Tipi restituiti

Restituisce una matrice di elementi con due campi, k ovvero campi con nome personalizzato o v .

Esempi

Questa sezione contiene esempi di come usare questo costrutto di linguaggio di query.

Convertire l'oggetto in una matrice

In questo esempio la OBJECTTOARRAY funzione viene usata per convertire un oggetto JSON in una matrice.

SELECT VALUE
  OBJECTTOARRAY({
    "a": "12345",
    "b": "67890"
  })
[
  [
    {
      "k": "a",
      "v": "12345"
    },
    {
      "k": "b",
      "v": "67890"
    }
  ]
]

Accesso alle proprietà dinamiche

Azure Cosmos DB linguaggio di query non fornisce una funzione predefinita per enumerare i nomi delle proprietà degli oggetti ,ad esempio OBJECT_KEYS. Per enumerare nomi di proprietà sconosciuti, usare OBJECTTOARRAY e JOIN sulle coppie chiave-valore risultanti.

{
  "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")

Questo modello restituisce una riga per proprietà in p.metadata per ogni elemento.

[
  { "id": "1", "propertyName": "color", "propertyValue": "blue" },
  { "id": "1", "propertyName": "size", "propertyValue": "small" }
]

Se è sufficiente verificare se esiste una proprietà specifica, usare IS_DEFINED.

SELECT p.id, IS_DEFINED(p.metadata["region"]) AS hasRegion
FROM p

Per migliorare le prestazioni delle query e un filtro più semplice, gli attributi delle variabili del modello come matrici, quando possibile, anziché usare chiavi oggetto dinamiche. Le matrici sono più facili da indicizzare e filtrare direttamente rispetto alle proprietà degli oggetti enumerate dinamicamente.