共用方式為

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

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

該 SUBSTRING 函數回傳從指定位置開始且長度相同的字串表達式的一部分。

Azure Cosmos 資料庫系統的函式，會回傳字串的部分，使用起始位置和長度。

語法

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

Arguments

Description
string_expr 字串運算式。
numeric_expr_1 一個以零為基礎的數值表達式，表示起始字元。 值 0 指的是第一個字元。
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": ""
  }
]

備註

  • 此函式使用以零為基礎的索引，意即指字 0 串中的第一個字元。
  • 若（ numeric_expr_2 長度）為負，函式回傳一個空字串。
  • 若要將子字串返回字串末尾，請使用該 LENGTH 函式計算剩餘字元（例如， SUBSTRING(str, start, LENGTH(str) - start)。
  • 此功能受益於範圍索引的使用。 如需詳細資訊，請參閱 範圍索引。
  • Last updated on