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 を取得します。