ARRAY_CONTAINS_ANY - Lenguaje de consulta en Cosmos DB (en Azure y Fabric)

La ARRAY_CONTAINS_ANY función devuelve un valor booleano que indica si la matriz contiene cualquiera de los valores especificados.

Syntax

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

Arguments

	Description
array_expr	Expresión de matriz.
expr	Expresión que se va a buscar en la matriz.
exprN	Una o varias expresiones adicionales para buscar dentro de la matriz.

Tipos de retorno

Devuelve un valor booleano.

Examples

Esta sección contiene ejemplos de cómo usar esta construcción del lenguaje de consulta.

La matriz contiene cualquier ejemplo

En este ejemplo, la ARRAY_CONTAINS_ANY función se usa para comprobar si hay valores o objetos específicos en una 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
  }
]

Observaciones

• STATIC-NOTIFY-NO-INDEX-USAGE