ARRAY_CONTAINS_ANY - Linguagem de consulta no Cosmos DB (no Azure e no Fabric)

A ARRAY_CONTAINS_ANY função retorna um booleano indicando se a matriz contém algum dos valores especificados.

Sintaxe

ARRAY_CONTAINS_ANY(<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 para procurar dentro da matriz.

Tipos de devolução

Retorna um valor booleano.

Examples

Esta seção contém exemplos de como usar essa construção de linguagem de consulta.

Array contém quaisquer exemplos

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

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

Observações

• STATIC-NOTIFY-NO-INDEX-USAGE