COPY

COPY ステアリングプロシージャは、ソースの内部 LOB の全部または一部をターゲットの内部 LOB にコピーします。

ソース LOB とターゲット LOB のオフセット、およびコピーするバイト数または文字数を指定できます。

構文

DBMS_LOB.COPY (
dest_lob    IN OUT NOCOPY BLOB,
src_lob     IN            BLOB,
amount      IN            INTEGER,
dest_offset IN            INTEGER := 1,
src_offset  IN            INTEGER := 1);

DBMS_LOB.COPY (
dest_lob    IN OUT NOCOPY CLOB CHARACTER SET ANY_CS,
src_lob     IN            CLOB CHARACTER SET ANY_CS,
amount      IN            INTEGER,
dest_offset IN            INTEGER := 1,
src_offset  IN            INTEGER := 1);

パラメータの説明

異常状況

使用方法

• ターゲット LOB で指定されたオフセットが、その LOB 内の現在のデータの終端を超える場合、ターゲット BLOB または CLOB にゼロバイトフィラーまたはスペースが挿入されます。オフセットがターゲット LOB の現在の長さより小さい場合、既存のデータは上書きされます。

• 指定した量がソース LOB 内のデータ長を超えてもエラーは報告されません。そのため、ソース LOB からコピーするデータ量を多く指定することができ、これにより src_offset からソース LOB の終端までのすべてのデータがコピーされます。

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

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

• コピー前に、ソースおよびターゲット LOB がアーカイブされている場合は、まずそれらを取得します。完全カバレッジの場合、ターゲット LOB は取得されません。