getBytes(long pos, int length) - Advanced SQL Engine - Teradata Database

Teradata Vantage™ - SQL外部ルーチン プログラミング

Product
Advanced SQL Engine
Teradata Database
Release Number
17.05
17.00
Published
2020年6月
Language
日本語
Last Update
2021-03-30
dita:mapPath
ja-JP/qwr1571437338192.ditamap
dita:ditavalPath
ja-JP/qwr1571437338192.ditaval
dita:id
B035-1147
Product Category
Software
Teradata Vantage

このBlobオブジェクトが表わす、BLOB値のすべてまたは一部をバイトの配列として取得します。

引数

引数 説明
pos 抽出されるBLOB値の最初のバイトの序数の位置。

最初のバイトは位置1にあります。

length コピーされる連続バイト数。

戻り値

結果のバイト配列には、位置lengthのバイトから始まり、このBlobオブジェクトによって指定されるBLOB値から最大でposまでの連続バイトが含まれます。

pos + length - 1がバイト単位のBLOBの長さより大きい場合、結果のバイト配列の長さはlengthより小さくなります。

例外

条件 getBytes()がSQLExceptionをスローする目的
BLOB値にアクセスする際にエラーが発生する LOBデータの読み取り中に予期しないエラーが発生したことを示し、SQLExceptionフィールドを以下のように設定します。
  • SQLStateフィールド = “TS000”
  • vendorCodeフィールド = 7851
pos引数の値が1より小さい

または

length引数の値が負である

無効な引数であることを示し、SQLExceptionフィールドを以下のように設定します。
  • SQLStateフィールド = “22023”
  • vendorCodeフィールド = 7859
length引数の値が現在のJVMに対して大きすぎるため、このメソッドで必要なメモリを割り当てることができない JVMヒープ メモリが使い尽くされたことを示し、SQLExceptionフィールドを以下のように設定します。
  • SQLStateフィールド = “TS000”
  • vendorCodeフィールド = 7856