17.00 - 17.05 - setString(long pos, java.lang.String str) - Advanced SQL Engine - Teradata Database

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

Product
Advanced SQL Engine
Teradata Database
Release Number
17.00
17.05
Published
2020年6月
Content Type
プログラミング リファレンス
Publication ID
B035-1147-170K-JPN
Language
日本語 (日本)

指定した文字列を、このClobオブジェクトが表わすCLOB値の末尾に付加し、書き込まれた文字数を戻します。

引数

引数 説明
pos 将来の使用に備えて予約されます。
str このClobオブジェクトが表わすCLOB値に付加する文字列。

戻り値

正常に行なわれた場合、setString()は書き込まれた文字数を戻します。

例外

条件 setString()がSQLExceptionをスローする目的
CLOB値にアクセスする際にエラーが発生する LOBへのデータの書き込み中にエラーが発生したことを示し、SQLExceptionフィールドを以下のように設定します。
  • SQLStateフィールド = “TS000”
  • vendorCodeフィールド = 7852
str引数がNULLである

または

pos引数の値が1より小さい

Java外部ルーチンが無効な引数でBLOBまたはCLOBメソッドを呼び出したことを示し、SQLExceptionフィールドを以下のように設定します。
  • SQLStateフィールド = “22023”
  • vendorCodeフィールド = 7859
JVMが、文字列をClobに書き込むための十分なメモリをメソッドに割り当てることができない 使用できるJVMヒープ メモリが使い尽くされたことを示し、SQLExceptionフィールドを以下のように設定します。
  • SQLStateフィールド = “TS000”
  • vendorCodeフィールド = 7856