STARTSWITH - Cosmos DB 中的查询语言

STARTSWITH 函数返回一个布尔值,该值指示第一个字符串表达式是否以第二个字符串表达式开头。

一个 Azure Cosmos DB for NoSQL 系统函数,该函数返回一个布尔值,指示一个字符串表达式是否以另一个字符串表达式开头。

Syntax

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

Arguments

Description
string_expr_1 字符串表达式。
string_expr_2 要与开头进行比较的 string_expr_1字符串表达式。
bool_expr 用于忽略大小写的可选值。 如果设置为 trueSTARTSWITH 则执行不区分大小写的搜索。 未指定时,此默认值为 false.

返回类型

返回布尔表达式。

例子

本部分包含有关如何使用此查询语言构造的示例。

检查字符串是否以另一个字符串开头

在此示例中,该 STARTSWITH 函数用于检查字符串是否以给定前缀开头,且不区分大小写。

SELECT VALUE {
  startsWithWrongPrefix: STARTSWITH("AdventureWorks", "Works"),
  startsWithCorrectPrefix: STARTSWITH("AdventureWorks", "Adventure"),
  startsWithPrefixWrongCase: STARTSWITH("AdventureWorks", "adventure"),
  startsWithPrefixCaseInsensitive: STARTSWITH("AdventureWorks", "adventure", true)
}
[
  {
    "startsWithWrongPrefix": false,
    "startsWithCorrectPrefix": true,
    "startsWithPrefixWrongCase": false,
    "startsWithPrefixCaseInsensitive": true
  }
]

注解

  • 此函数执行精确的索引扫描。