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

Функция ARRAY_CONTAINS_ANY возвращает логическое значение, указывающее, содержит ли массив любой из указанных значений.

Синтаксис

ARRAY_CONTAINS_ANY(<array_expr>, <expr> [, exprN])

Arguments

	Description
array_expr	Выражение массива.
expr	Выражение для поиска в массиве.
exprN	Одно или несколько дополнительных выражений для поиска в массиве.

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

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

Примеры

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

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

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

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

Замечание

В приведенных выше undefined примерах используется в качестве значения поиска. Когда undefined передается в качестве аргумента, он не соответствует ни одному значению в массиве. Сравниваются только явно определенные значения.

Замечания

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