ARRAY_CONTAINS_ANY – Frågespråk i Cosmos DB (i Azure och Fabric)

Funktionen ARRAY_CONTAINS_ANY returnerar ett booleskt värde som anger om matrisen innehåller något av de angivna värdena.

Syntax

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

Arguments

	Description
array_expr	Ett matrisuttryck.
expr	Uttryck att söka efter i matrisen.
exprN	Ett eller flera extra uttryck att söka efter i matrisen.

Returtyper

Returnerar ett booleskt värde.

Examples

Det här avsnittet innehåller exempel på hur du använder den här frågespråkkonstruktionen.

Matrisen innehåller alla exempel

I det här exemplet ARRAY_CONTAINS_ANY används funktionen för att söka efter specifika värden eller objekt i en matris.

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

Anmärkningar

• STATIC-NOTIFY-NO-INDEX-USAGE