Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
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.