次の方法で共有


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

CONTAINS関数は、最初の文字列式に 2 番目の文字列式が含まれているかどうかを示すブール値を返します。

構文

CONTAINS(<string_expr_1>, <string_expr_2> [, <bool_expr>])

論争

Description
string_expr_1 検索する最初の文字列。
string_expr_2 検索する 2 番目の文字列。
bool_expr 大文字と小文字を区別する省略可能なブール値。 trueに設定すると、CONTAINSは大文字と小文字を区別しない検索を実行します。 unspecifiedすると、この値の既定値は false になります。

戻り値の型

ブール式を返します。

例示

このセクションでは、このクエリ言語コンストラクトを使用する方法の例を示します。

文字列の例が含まれています

この例では、 CONTAINS 関数を使用して、文字列内の部分文字列をチェックします。

SELECT VALUE {
  containsPrefix: CONTAINS("AdventureWorks", "Adventure"), 
  containsSuffix: CONTAINS("AdventureWorks", "Works"),
  containsWrongCase: CONTAINS("AdventureWorks", "adventure"), 
  containsWrongCaseValidateCase: CONTAINS("AdventureWorks", "adventure", false), 
  containsWrongCaseIgnoreCase: CONTAINS("AdventureWorks", "works", true),
  containsMismatch: CONTAINS("AdventureWorks", "Contoso")
}
[
  {
    "containsPrefix": true,
    "containsSuffix": true,
    "containsWrongCase": false,
    "containsWrongCaseValidateCase": false,
    "containsWrongCaseIgnoreCase": true,
    "containsMismatch": false
  }
]

注釈

  • この関数はフル スキャンを実行します。