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

CONTAINS（NoSQL 查询）

  • 项目

适用范围： NoSQL

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

语法

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

参数

说明
string_expr_1 要搜索的第一个字符串。
string_expr_2 要查找的第二个字符串。
bool_expr（可选） 用于忽略大小写的可选布尔值。 设置为 true 时，CONTAINS 执行不区分大小写的搜索。 如果为 unspecified，此值默认为 false。

返回类型

返回一个布尔表达式。

示例

以下示例检查字符串中是否存在各种静态子字符串。

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

注解

  • 此函数会执行完全扫描。

相关内容