你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
适用范围: 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
  }
]
注解
- 此函数会执行完全扫描。