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

SUBSTRING 函数返回从指定位置和指定长度或字符串末尾开始的字符串表达式的一部分。

一个 Azure Cosmos DB for NoSQL 系统函数,该函数使用起始位置和长度返回字符串的一部分。

Syntax

SUBSTRING(<string_expr>, <numeric_expr_1>, <numeric_expr_2>)

Arguments

Description
string_expr 字符串表达式。
numeric_expr_1 表示起始字符的数字表达式。
numeric_expr_2 表示要返回的最大字符 string_expr 数的数字表达式。

返回类型

返回字符串表达式。

例子

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

从字符串中提取子字符串

在此示例中,函数 SUBSTRING 用于返回具有各种长度和起始位置的子字符串。

SELECT VALUE {
  substringPrefix: SUBSTRING("AdventureWorks", 0, 9),
  substringSuffix: SUBSTRING("AdventureWorks", 9, 5),
  substringTotalLength: SUBSTRING("AdventureWorks", 0, LENGTH("AdventureWorks")),
  substringEmptyString: SUBSTRING("AdventureWorks", 0, -1)
}
[
  {
    "substringPrefix": "Adventure",
    "substringSuffix": "Works",
    "substringTotalLength": "AdventureWorks",
    "substringEmptyString": ""
  }
]

注解

  • 此函数受益于范围索引的使用。 有关详细信息,请参阅 范围索引