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 は検索されません。