Partager via


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

La ARRAY_CONTAINS_ALL fonction retourne une valeur booléenne indiquant si le tableau contient toutes les valeurs spécifiées.

Syntaxe

ARRAY_CONTAINS_ALL(<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 tous les exemples

Dans cet exemple, la ARRAY_CONTAINS_ALL fonction est utilisée pour rechercher des valeurs ou des objets spécifiques dans un tableau.

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

Remarques

  • STATIC-NOTIFY-NO-INDEX-USAGE