BYTES_SUBSTRING
UTF-8 エンコードされたバイト表現のバイト単位のオフセットを使用して、入力値の部分文字列を返します。部分的な文字と無効な UTF-8 コードポイントは、結果から削除されます。
構文
クエリに BYTES_SUBSTRING 関数を組み込むには、次の構文を使用します。
BYTES_SUBSTRING(value, startIndex, endIndex)
引数
BYTES_SUBSTRING 関数には、次の引数が必要です。
value入力は、部分文字列関数を実行する文字列です。startIndexは1から始まり、文字列の最初の文字を含みます。endIndexは、startIndexの位置からではなく、文字列の最初の文字から数えます。
| 名前 | 型 | 説明 | 既定値 |
|---|---|---|---|
| value | string | 部分文字列関数を実行する入力値 | |
| startIndex | int | バイト単位の開始インデックス (含む) | |
| endIndex | int | バイト単位の終了インデックス (含まない) |
戻り値
string の値を返します。
例
次の例は、startIndex と endIndex の引数が Output の値にどのように影響するかを示しています。ここでは、endIndex の値は、startIndex の値に関係なく、endIndex が文字列の 1 番目の位置から始まり、10 文字を含めるように機能することを示しています。
| value | startIndex | endIndex | 出力 |
|---|---|---|---|
| 'Hello World' | 1 | 10 | `Hello Worl` |
| 'Hello World' | 2 | 10 | `ello Worl` |
| '⻤Hello Wor⻤' | 2 | 10 | `Hello W` |
| '⻤Hello Wor⻤' | 1 | 10 | `⻤Hello W` |
| 'Hello' | 1 | 10 | `Hello` |