次の方法で共有

SUBSTRING - Cosmos DB のクエリ言語 (Azure と Fabric)

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

SUBSTRING関数は、指定した位置と指定した長さから始まる文字列式の一部を返します。

開始位置と長さを使用して文字列の一部を返す Azure Cosmos DB システム関数。

構文

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

論争

Description
string_expr 文字列式。
numeric_expr_1 開始文字を示す 0 から始まる数値式。 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 から始まるインデックス作成を使用します。つまり、 0 は文字列の最初の文字を参照します。
  • numeric_expr_2 (長さ) が負の場合、関数は空の文字列を返します。
  • 文字列の末尾に部分文字列を返すには、 LENGTH 関数を使用して、残りの文字 (たとえば、 SUBSTRING(str, start, LENGTH(str) - start)) を計算します。
  • この関数は、範囲インデックスを使用する利点があります。 詳細については、「 範囲インデックス」を参照してください。
  • Last updated on