通过

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

SUBSTRING（NoSQL 查询）

  • 项目

适用范围： NoSQL

返回字符串表达式的部分内容，该内容起于指定位置并具有指定长度，或者至字符串结尾。

语法

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

参数

说明
string_expr 一个字符串表达式。
numeric_expr_1 表示开始字符的数值表达式。
numeric_expr_2 一个数值表达式，表示要返回的 string_expr 的最大字符数。

返回类型

返回一个字符串表达式。

示例

以下示例返回具有各种长度和起始位置的子字符串。

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

注解

  • 如果起始位置是 0，则此函数受益于范围索引。
  • numeric_expr_1 位置从零开始，因此 0 的值从 string_expr 的第一个字符开始。
  • numeric_expr_2 的值为 0 或更小将导致空字符串。

相关内容