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

La ARRAY_CONTAINS_ALL funzione restituisce un valore booleano che indica se la matrice contiene tutti i valori specificati.

Sintassi

ARRAY_CONTAINS_ALL(<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 tutti gli esempi

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

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

Osservazioni:

• STATIC-NOTIFY-NO-INDEX-USAGE