ARRAY_CONTAINS_ANY - Querytaal in Cosmos DB (in Azure en Fabric)

De ARRAY_CONTAINS_ANY functie retourneert een Booleaanse waarde die aangeeft of de matrix een van de opgegeven waarden bevat.

Syntaxis

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

Arguments

	Description
array_expr	Een matrixexpressie.
expr	Expressie om te zoeken in de matrix.
exprN	Een of meer extra expressies om te zoeken in de matrix.

Retourtypen

Retourneert een Booleaanse waarde.

Voorbeelden

Deze sectie bevat voorbeelden van het gebruik van deze querytaalconstructie.

Matrix bevat voorbeelden

In dit voorbeeld wordt de ARRAY_CONTAINS_ANY functie gebruikt om te controleren op specifieke waarden of objecten in een matrix.

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

Opmerkingen

• STATIC-NOTIFY-NO-INDEX-USAGE