WRITEAPPEND

WRITEAPPEND ステートメントは、内部 LOB の末尾に指定された量のデータを書き込みます。データは buffer パラメータによって書き込まれます。

構文

DBMS_LOB.WRITEAPPEND (
lob_loc IN OUT NOCOPY BLOB,
amount  IN            INTEGER,
buffer  IN            RAW);

DBMS_LOB.WRITEAPPEND (
lob_loc IN OUT NOCOPY CLOB CHARACTER SET ANY_CS,
amount  IN            INTEGER,
buffer  IN            VARCHAR2 CHARACTER SET ANY_CS);

パラメータ説明

例外

使用方法

• VARCHAR バッファの形式は CLOB パラメータの形式と一致している必要があります。LOB パラメータの型を CLOB に設定した場合、バッファには CHAR データを含める必要があります。

• クライアントから DBMS_LOB.WRITEAPPEND を呼び出す場合（例：OBClientの BEGIN / END ブロック内）、バッファにはクライアントの文字セットのデータを含める必要があります。バッファデータを LOB に書き込む前に、データベースはクライアントのバッファをサーバーの文字セットに変換します。

• LOB 操作をOpen/Closeインターフェースでラップする必要はありません。操作を実行する前にLOBを開いていない場合、呼び出しの過程でLOB列上の機能インデックスとドメインインデックスが更新されます。しかし、操作を実行する前にLOBを開いている場合は、トランザクションをコミットする前に必ず閉じる必要があります。内部LOBを閉じる際、LOB列上の機能インデックスとドメインインデックスが更新されます。

• LOB操作をOpen/Close APIでラップしない場合、LOBに書き込むたびに機能インデックスとドメインインデックスが更新されます。これはパフォーマンスに悪影響を及ぼします。そのため、LOBへの書き込み操作はOPENまたはCLOSEステートメント内に含めることを推奨します。

• 必要に応じて、LOBに追加する前に、WRITEAPPENDでLOBを取得します。