次の方法で共有

ARRAY_CONTAINS - Cosmos DB のクエリ言語 (Azure と Fabric)

  • 適用対象: ✅ Azure Cosmos DB for NoSQL, ✅ Cosmos DB in Microsoft Fabric

ARRAY_CONTAINS関数は、配列に指定した値が含まれているかどうかを示すブール値を返します。 関数内のブール式を使用して、オブジェクトの部分的または完全な一致を確認できます。

構文

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

論争

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

注釈

  • この関数は、範囲インデックスを使用する利点があります。 詳細については、「 範囲インデックス」を参照してください。
  • Last updated on