SUBSTRING関数は、指定した位置と指定した長さ、または文字列の末尾から始まる文字列式の一部を返します。
開始位置と長さを使用して文字列の一部を返す Azure Cosmos DB for NoSQL システム関数。
構文
SUBSTRING(<string_expr>, <numeric_expr_1>, <numeric_expr_2>)
論争
| 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": ""
}
]
注釈
- この関数は、範囲インデックスを使用する利点があります。 詳細については、「 範囲インデックス」を参照してください。