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

A ARRAY_CONTAINS função retorna um booleano indicando se a matriz contém o valor especificado. Você pode verificar uma correspondência parcial ou total de um objeto usando uma expressão booleana dentro da função.

Sintaxe

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

Arguments

	Description
array_expr	Uma expressão de matriz.
expr	Expressão a ser pesquisada dentro da matriz.
bool_expr	Uma expressão booleana que indica se a pesquisa deve verificar se há uma correspondência parcial (true) ou uma correspondência completa (false). Se não for especificado, o valor padrão será false.

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 exemplos

Neste exemplo, a ARRAY_CONTAINS função é usada para verificar a presença de valores e objetos em matrizes.

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

Observações

• Esta função beneficia da utilização de um índice de intervalo. Para obter mais informações, consulte Índices de intervalo.