Partager via


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

La ARRAY_CONTAINS_ANY fonction retourne une valeur booléenne indiquant si le tableau contient l’une des valeurs spécifiées.

Syntaxe

ARRAY_CONTAINS_ANY(<array_expr>, <expr> [, exprN])

Arguments

Descriptif
array_expr Expression de tableau.
expr Expression à rechercher dans le tableau.
exprN Une ou plusieurs expressions supplémentaires à rechercher dans le tableau.

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_ANY fonction est utilisée pour rechercher des valeurs ou des objets spécifiques dans un tableau.

SELECT VALUE {
  matchesEntireArray: ARRAY_CONTAINS_ANY([1, true, "3", [1,2,3]], 1, true, "3", [1,2,3]),
  matchesSomeValues: ARRAY_CONTAINS_ANY([1, 2, 3, 4], 2, 3, 4, 5),
  matchSingleValue: ARRAY_CONTAINS_ANY([1, 2, 3, 4], 1, undefined),
  noMatches: ARRAY_CONTAINS_ANY([1, 2, 3, 4], 5, 6, 7, 8),
  emptyArray: ARRAY_CONTAINS_ANY([], 1, 2, 3),
  noMatchesUndefined: ARRAY_CONTAINS_ANY([1, 2, 3, 4], 5, undefined)
}
[
  {
    "matchesEntireArray": true,
    "matchesSomeValues": true,
    "matchSingleValue": true,
    "noMatches": false,
    "emptyArray": false
  }
]

Remarques

  • STATIC-NOTIFY-NO-INDEX-USAGE