共用方式為

SUBSTRING - Cosmos DB 中的查詢語言 （在 Azure 和 Fabric 中）

  • 適用於: ✅ Azure Cosmos DB for NoSQL, ✅ Cosmos DB in Microsoft Fabric

函數 SUBSTRING 會傳回從指定位置和指定長度開始的字串運算式的一部分，或到字串結尾。

適用於 NoSQL 的 Azure Cosmos DB 系統函式，會使用起始位置和長度傳回字串的一部分。

語法

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

備註

  • 此功能受益於範圍索引的使用。 如需詳細資訊，請參閱 範圍索引。
  • Last updated on