ARRAY_CONTAINS_ALL – Linguagem de consulta no Cosmos DB (no Azure e no Fabric)

A ARRAY_CONTAINS_ALL função retorna um booliano que indica se a matriz contém todos os valores especificados.

Sintaxe

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

Arguments

	Description
array_expr	Uma expressão de matriz.
expr	Expressão a ser pesquisada dentro da matriz.
exprN	Uma ou mais expressões extras a serem pesquisadas dentro da matriz.

Tipos de retorno

Retorna um valor booliano.

Exemplos

Esta seção contém exemplos de como usar este constructo de linguagem de consulta.

A matriz contém todos os exemplos

Neste exemplo, a ARRAY_CONTAINS_ALL função é usada para verificar valores ou objetos específicos em uma matriz.

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

Observações

• STATIC-NOTIFY-NO-INDEX-USAGE