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 は取得されません。