通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

ARRAY_CONTAINS_ALL （NoSQL 查询）

  • 项目

适用范围： NoSQL

返回一个布尔值，该值指示第一个数组是否包含以下所有元素。

语法

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

参数

说明
array_expr 一个数组表达式。
expr 要在数组中搜索的表达式。
exprN （可选） 要搜索数组中的一个或多个额外表达式。

返回类型

返回一个布尔值。

示例

以下示例演示如何使用此函数检查数组中是否有特定的值或对象。

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

注解

  • 此系统函数不使用索引。

相关内容