Condividi tramite

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

  • Si applica a: ✅ Azure Cosmos DB, ✅ Cosmos DB in Microsoft Fabric

La CHOOSE funzione restituisce l'espressione in corrispondenza dell'indice specificato di un elenco oppure undefined se l'indice supera i limiti dell'elenco.

Sintassi

CHOOSE(<numeric_expr>, <expr_1> [, <expr_N>])

Arguments

Description
numeric_expr Espressione numerica, che specifica l'indice utilizzato per ottenere un'espressione specifica nell'elenco. L'indice iniziale dell'elenco è 1.
expr_1 Prima espressione nell'elenco.
expr_N Espressioni facoltative, che possono contenere un numero variabile di espressioni fino all'N° elemento nell'elenco.

Tipi restituiti

Restituisce un'espressione, che può essere di qualsiasi tipo.

Esempi

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

Si consideri questo set di documenti di esempio all'interno della Products raccolta per questi esempi.

[
  {
    "name": "Vimero Hydration Pack",
    "category": "gear",
    "sku": "69500",
    "detailCategory": "gear-hike-hydration-packs"
  },
  {
    "name": "Mt. Hood Hydration Pack",
    "category": "gear",
    "sku": "69501",
    "detailCategory": "gear-hike-hydration-packs"
  }
]

Scegliere da un elenco

In questo esempio la CHOOSE funzione viene usata per selezionare il valore in corrispondenza dell'indice 1.

SELECT VALUE 
  CHOOSE(1, "Vimero", "Hydration", "Pack")

[
  "Vimero"
]

Scegliere per indice

In questo esempio la CHOOSE funzione viene usata per selezionare i valori in indici diversi.

SELECT VALUE {
  index_0: CHOOSE(0, "Mt.", "Hood", "Hydration", "Pack"),
  index_1: CHOOSE(1, "Mt.", "Hood", "Hydration", "Pack"),
  index_2: CHOOSE(2, "Mt.", "Hood", "Hydration", "Pack"),
  index_3: CHOOSE(3, "Mt.", "Hood", "Hydration", "Pack"),
  index_4: CHOOSE(4, "Mt.", "Hood", "Hydration", "Pack"),
  index_5: CHOOSE(5, "Mt.", "Hood", "Hydration", "Pack")
}

[
  {
    "index_1": "Mt.",
    "index_2": "Hood",
    "index_3": "Hydration",
    "index_4": "Pack"
  }
]

Annotazioni

In questo esempio index_0 e index_5 vengono omessi dall'output perché CHOOSE restituisce undefined per indici non compresi nell'intervallo e le proprietà con undefined valori non sono inclusi negli oggetti JSON.

Scegliere il campo dal prodotto

In questo esempio, la CHOOSE funzione viene usata per selezionare il terzo campo dei prodotti nella gear-hike-hydration-packs categoria .

SELECT VALUE
  CHOOSE(3, p.category, p.name, p.sku)
FROM
  products p
WHERE
  p.detailCategory = "gear-hike-hydration-packs"

[
  "69500",
  "69501"
]

Osservazioni:

  • Questa funzione non usa l'indice.
  • Questa funzione usa l'indicizzazione in base uno, ovvero il primo elemento dell'elenco è in corrispondenza dell'indice 1 anziché l'indicizzazione tipica in base zero presente in molti linguaggi di programmazione.
  • Se l'indice non è compreso nell'intervallo, la funzione restituisce undefined. Quando si costruisce un oggetto, le proprietà con undefined valori vengono omesse dal risultato.
  • Last updated on