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

La ARRAY_CONTAINS fonction retourne une valeur booléenne indiquant si le tableau contient la valeur spécifiée. Vous pouvez rechercher une correspondance partielle ou complète d’un objet à l’aide d’une expression booléenne dans la fonction.

Syntaxe

ARRAY_CONTAINS(<array_expr>, <expr> [, <bool_expr>])

Arguments

	Descriptif
array_expr	Expression de tableau.
expr	Expression à rechercher dans le tableau.
bool_expr	Expression booléenne indiquant si la recherche doit rechercher une correspondance partielle (true) ou une correspondance complète (false). Si elle n’est pas spécifiée, la valeur par défaut est false.

Types de retour

Retourne une valeur booléenne.

Examples

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

Tableau contient des exemples

Dans cet exemple, la ARRAY_CONTAINS fonction est utilisée pour vérifier la présence de valeurs et d’objets dans des tableaux.

SELECT VALUE {
  containsItem: ARRAY_CONTAINS(["coats", "jackets", "sweatshirts"], "coats"),
  missingItem: ARRAY_CONTAINS(["coats", "jackets", "sweatshirts"], "hoodies"),
  containsFullMatchObject: ARRAY_CONTAINS([{ category: "shirts", color: "blue" }], { category: "shirts", color: "blue" }),
  missingFullMatchObject: ARRAY_CONTAINS([{ category: "shirts", color: "blue" }], { category: "shirts" }),
  containsPartialMatchObject: ARRAY_CONTAINS([{ category: "shirts", color: "blue" }], { category: "shirts" }, true),
  missingPartialMatchObject: ARRAY_CONTAINS([{ category: "shirts", color: "blue" }], { category: "shorts", color: "blue" }, true)
}

[
  {
    "containsItem": true,
    "missingItem": false,
    "containsFullMatchObject": true,
    "missingFullMatchObject": false,
    "containsPartialMatchObject": true,
    "missingPartialMatchObject": false
  }
]

Remarques

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