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