Compartir a través de

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

  • Se aplica a: ✅ Azure Cosmos DB, ✅ Cosmos DB in Microsoft 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)
}

[
  {
    "emptyArray": false,
    "matchSingleValue": true,
    "matchesEntireArray": true,
    "matchesSomeValues": true,
    "noMatches": false
  }
]

Nota:

En los ejemplos anteriores, undefined se usa como valor de búsqueda. Cuando undefined se pasa como argumento, no coincide con ningún valor de la matriz. Solo se comparan los valores definidos explícitamente.

Observaciones

  • Esta función no utiliza el índice.
  • Last updated on