ARRAY_CONTAINS_ANY - Linguaggio di query in Cosmos DB (in Azure e Fabric)

La ARRAY_CONTAINS_ANY funzione restituisce un valore booleano che indica se la matrice contiene uno dei valori specificati.

Sintassi

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

Arguments

	Description
array_expr	Espressione di matrice.
expr	Espressione da cercare all'interno della matrice.
exprN	Una o più espressioni aggiuntive da cercare all'interno della matrice.

Tipi restituiti

Restituisce un valore booleano.

Esempi

Questa sezione contiene esempi di come usare questo costrutto di linguaggio di query.

La matrice contiene esempi

In questo esempio, la ARRAY_CONTAINS_ANY funzione viene usata per verificare la presenza di valori o oggetti specifici in una matrice.

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

Osservazioni:

• STATIC-NOTIFY-NO-INDEX-USAGE