ARRAY_CONTAINS — язык запросов в Cosmos DB (в Azure и Fabric)

Функция ARRAY_CONTAINS возвращает логическое значение, указывающее, содержит ли массив указанное значение. Можно проверить частичное или полное соответствие объекта с помощью логического выражения в функции.

Синтаксис

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

Arguments

	Description
array_expr	Выражение массива.
expr	Выражение для поиска в массиве.
bool_expr	Логическое выражение, указывающее, должен ли поиск проверять частичное совпадение (true) или полное совпадение (false). Если не задано, по умолчанию используется значение false.

Типы возвращаемых данных

Возвращает логическое значение.

Примеры

В этом разделе содержатся примеры использования этой конструкции языка запросов.

Массив содержит примеры

В этом примере ARRAY_CONTAINS функция используется для проверки наличия значений и объектов в массивах.

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

Замечания

• Эта функция использует индекс диапазона. Дополнительные сведения см. в разделе индексов диапазона.