ARRAY_CONTAINS_ALL - Cosmos DB 中的查询语言(在 Azure 和 Fabric 中)

ARRAY_CONTAINS_ALL 函数返回一个布尔值,该值指示数组是否包含所有指定值。

Syntax

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

Arguments

Description
array_expr 数组表达式。
expr 要搜索数组中的表达式。
exprN 在数组中搜索的一个或多个额外表达式。

返回类型

返回布尔值。

例子

本部分包含有关如何使用此查询语言构造的示例。

数组包含所有示例

在此示例中,该 ARRAY_CONTAINS_ALL 函数用于检查数组中的特定值或对象。

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

注解

  • STATIC-NOTIFY-NO-INDEX-USAGE