共用方式為


ARRAY_CONTAINS_ALL - Cosmos DB 中的查詢語言 (在 Azure 和 Fabric 中)

ARRAY_CONTAINS_ALL 式會傳回布林值,指出陣列是否包含所有指定的值。

語法

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

備註

  • 靜態通知不INDEX-USAGE