WRITE

WRITE ステートメントは、指定された数のデータを内部 LOB（LOB で始まる絶対オフセットから計算）に書き込むために使用されます。

データは buffer パラメータから書き込まれます。WRITE は、指定された長さで LOB オフセット内に既存するデータを置き換え（上書き）ます。

構文

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

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

パラメータの説明

異常時の対処

使用方法

• 入力量がバッファ内のデータより大きい場合、エラーが発生します。入力量がバッファ内のデータより小さい場合、バッファ内のバイトまたは文字数のみが LOB に書き込まれます。指定されたオフセットが LOB 内の現在のデータの末尾を超えると、BLOB または CLOB にそれぞれゼロバイトフィラーまたはスペースが挿入されます。

• VARCHAR2 バッファの形式は、CLOB パラメータの形式と一致していなければなりません。つまり、LOB パラメータの型が CLOB の場合、バッファには CHAR データが含まれていなければなりません。

• クライアントから DBMS_LOB_WRITE を呼び出す際、バッファにはクライアント文字セットのデータが含まれていなければなりません。バッファデータを LOB に書き込む前に、データベースはクライアントバッファをサーバーの文字セットに変換します。

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

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

• 必要に応じて、WRITE は LOB を書き込む前に LOB を取得します。ただし、書き込み操作が LOB全体を上書きするように指定されている場合はこの限りではありません。