Condividi tramite


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

La IS_ARRAY funzione restituisce un valore booleano che indica se il tipo dell'espressione specificata è una matrice.

Funzione di sistema Di Azure Cosmos DB per NoSQL che restituisce un valore booleano che indica se un'espressione è una matrice.

Sintassi

IS_ARRAY(<expr>)

Arguments

Description
expr Qualsiasi espressione.

Tipi restituiti

Restituisce un'espressione booleana.

Esempi

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

Controllare se il valore è matrice

In questo esempio la IS_ARRAY funzione viene usata per controllare gli oggetti di vari tipi.

SELECT VALUE {
  booleanIsArray: IS_ARRAY(true),
  numberIsArray: IS_ARRAY(65),
  stringIsArray: IS_ARRAY("AdventureWorks"),
  nullIsArray: IS_ARRAY(null),
  objectIsArray: IS_ARRAY({size: "small"}),
  arrayIsArray: IS_ARRAY([25344, 82947]),
  arrayObjectPropertyIsArray: IS_ARRAY({skus: [25344, 82947], vendors: null}.skus),
  invalidObjectPropertyIsArray: IS_ARRAY({skus: [25344, 82947], vendors: null}.size),
  nullObjectPropertyIsArray: IS_ARRAY({skus: [25344, 82947], vendors: null}.vendor)
}
[
  {
    "booleanIsArray": false,
    "numberIsArray": false,
    "stringIsArray": false,
    "nullIsArray": false,
    "objectIsArray": false,
    "arrayIsArray": true,
    "arrayObjectPropertyIsArray": true,
    "invalidObjectPropertyIsArray": false,
    "nullObjectPropertyIsArray": false
  }
]

Osservazioni:

  • Questa funzione trae vantaggio dall'uso di un indice di intervallo. Per altre informazioni, vedere Indici di intervallo.