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

La ARRAY_CONTAINS función devuelve un valor booleano que indica si la matriz contiene el valor especificado. Puede comprobar si hay una coincidencia parcial o completa de un objeto mediante una expresión booleana dentro de la función .

Syntax

ARRAY_CONTAINS(<array_expr>, <expr> [, <bool_expr>])

Arguments

	Description
array_expr	Expresión de matriz.
expr	Expresión que se va a buscar en la matriz.
bool_expr	Expresión booleana que indica si la búsqueda debe comprobar si hay una coincidencia parcial (true) o una coincidencia completa (false). Si no se especifica, el valor predeterminado es false.

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 ejemplos

En este ejemplo, la ARRAY_CONTAINS función se usa para comprobar la presencia de valores y objetos en matrices.

SELECT VALUE {
  containsItem: ARRAY_CONTAINS(["coats", "jackets", "sweatshirts"], "coats"),
  missingItem: ARRAY_CONTAINS(["coats", "jackets", "sweatshirts"], "hoodies"),
  containsFullMatchObject: ARRAY_CONTAINS([{ category: "shirts", color: "blue" }], { category: "shirts", color: "blue" }),
  missingFullMatchObject: ARRAY_CONTAINS([{ category: "shirts", color: "blue" }], { category: "shirts" }),
  containsPartialMatchObject: ARRAY_CONTAINS([{ category: "shirts", color: "blue" }], { category: "shirts" }, true),
  missingPartialMatchObject: ARRAY_CONTAINS([{ category: "shirts", color: "blue" }], { category: "shorts", color: "blue" }, true)
}

[
  {
    "containsItem": true,
    "missingItem": false,
    "containsFullMatchObject": true,
    "missingFullMatchObject": false,
    "containsPartialMatchObject": true,
    "missingPartialMatchObject": false
  }
]

Observaciones

• Esta función se beneficia del uso de un índice de intervalo. Para obtener más información, vea Índices de intervalo.