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全体を上書きすることを指定している場合はこの限りではありません。