Partager via


IS_ARRAY - Langage de requête dans Cosmos DB (dans Azure et Fabric)

La IS_ARRAY fonction retourne une valeur booléenne indiquant si le type de l’expression spécifiée est un tableau.

Fonction système Azure Cosmos DB pour NoSQL qui retourne une valeur booléenne indiquant si une expression est un tableau.

Syntaxe

IS_ARRAY(<expr>)

Arguments

Descriptif
expr Toute expression.

Types de retour

Retourne une expression booléenne.

Examples

Cette section contient des exemples d’utilisation de cette construction de langage de requête.

Vérifier si la valeur est matricielle

Dans cet exemple, la IS_ARRAY fonction est utilisée pour vérifier les objets de différents types.

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
  }
]

Remarques

  • Cette fonction tire parti de l’utilisation d’un index de plage. Pour plus d’informations, consultez les index de plage.