Compartir vía


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

La ARRAY_CONTAINS_ALL función devuelve un valor booleano que indica si la matriz contiene todos los valores especificados.

Syntax

ARRAY_CONTAINS_ALL(<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.

Matriz contiene todos los ejemplos

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

Observaciones

  • STATIC-NOTIFY-NO-INDEX-USAGE