メイン コンテンツをスキップする 補完的コンテンツへスキップ

BYTES_SUBSTRING

UTF-8 エンコードされたバイト表現のバイト単位のオフセットを使用して、入力値の部分文字列を返します。部分的な文字と無効な UTF-8 コードポイントは、結果から削除されます。

構文

クエリに BYTES_SUBSTRING 関数を組み込むには、次の構文を使用します。

BYTES_SUBSTRING(value, startIndex, endIndex)

引数

BYTES_SUBSTRING 関数には、次の引数が必要です。

  • value 入力は、部分文字列関数を実行する文字列です。
  • startIndex1 から始まり、文字列の最初の文字を含みます。
  • endIndex は、startIndex の位置からではなく、文字列の最初の文字から数えます。
名前 説明 既定値
value string 部分文字列関数を実行する入力値
startIndex int バイト単位の開始インデックス (含む)
endIndex int バイト単位の終了インデックス (含まない)

戻り値

string の値を返します。


次の例は、startIndexendIndex の引数が 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`

このページは役に立ちましたか?

このページまたはコンテンツにタイポ、ステップの省略、技術的エラーなどの問題が見つかった場合はお知らせください。