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

CONTAINS 函数返回一个布尔值,该值指示第一个字符串表达式是否包含第二个字符串表达式。

Syntax

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

Arguments

Description
string_expr_1 要搜索的第一个字符串。
string_expr_2 要查找的第二个字符串。
bool_expr 用于忽略大小写的可选布尔值。 如果设置为 trueCONTAINS 则执行不区分大小写的搜索。 当 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
  }
]

注解

  • 此函数执行完全扫描。