256 UTL_COMPRESS
256.2 UTL_COMPRESSの例外
この表は、UTL_COMPRESSサブプログラムで発生する例外について説明しています。
表256-1 UTL_COMPRESSの例外
例外 | 説明 |
---|---|
|
圧縮後の表現が大きすぎます。 |
|
入力または出力データ・ストリームの書式が無効です。 |
|
1つの引数のタイプまたは値が無効です。 |
|
ピース単位の圧縮または圧縮解除には無効なハンドルです。 |
|
データ・ストリームの圧縮または圧縮解除中にエラーが発生しました。 |
256.3 UTL_COMPRESSの操作上のノート
UTL_COMPRESS
には、特定の操作上のノートが適用されます。
-
LZ
*ファンクションによって戻された一時LOB
は、コール元がDBMS_LOB.FREETEMPORARY
コールを使用して解放する必要があります。 -
LZ_COMPRESS
*またはLZ_UNCOMPRESS
*に渡されたBFILE
は、DBMS_LOB.FILEOPEN
でオープンする必要があります。 -
特別な状況(入力がすでに圧縮されている場合)では、
UTL_COMPRESS
サブプログラムの1つで生成された出力が、入力と同じ大きさかまたは入力よりもわずかに大きくなることがあります。 -
UTL_COMPRESS
で圧縮したデータの出力は、1つのファイル上のgzip
(-n
オプションを指定)/gunzip
と互換性があります。
256.4 UTL_COMPRESSサブプログラムの要約
この表は、UTL_COMPRESS
サブプログラムを示し、簡単に説明しています。
256-2 UTL_COMPRESSパッケージのサブプログラム
サブプログラム | 説明 |
---|---|
ピース単位の圧縮(または圧縮解除)コンテキストに対するハンドルが、オープンしているかクローズしているかどうかを確認します。 |
|
Lempel-Ziv圧縮アルゴリズムを使用してデータを圧縮します。 |
|
1つの圧縮データを追加します。 |
|
ピース単位の圧縮操作をクローズして終了します。 |
|
圧縮状態とデータを保持するピース単位のコンテキストを初期化します。 |
|
圧縮された入力を受け入れ、有効であることを確認して圧縮を解除します。 |
|
1つの圧縮解除データを抽出します。 |
|
圧縮解除状態とデータを保持するピース単位のコンテキストを初期化します。 |
|
ピース単位の圧縮解除をクローズして終了します。 |
256.4.1 ISOPENファンクション
このファンクションは、ピース単位の圧縮(または圧縮解除)コンテキストに対するハンドルが、オープンしているかクローズしているかどうかを確認します。
構文
UTL_COMPRESS.ISOPEN( handle in binary_integer) RETURN BOOLEAN;
パラメータ
表256-3 ISOPENファンクションのパラメータ
パラメータ | 説明 |
---|---|
|
ピース単位の圧縮解除コンテキストへのハンドル。 |
戻り値
指定したピース単位のハンドルがオープンしている場合はTRUE
、それ以外の場合はFALSE
。
例
IF (UTL_COMPRESS.ISOPEN(myhandle) = TRUE) then UTL_COMPRESS.LZ_COMPRESS_CLOSE(myhandle, lob_1); END IF;
次のようにコーディングすることもできます。
IF (UTL_COMPRESS.ISOPEN(myhandle) = TRUE) THEN UTL_COMPRESS.LZ_UNCOMPRESS_CLOSE(myhandle); END IF;
256.4.2 LZ_COMPRESSファンクションおよびプロシージャ
このファンクションおよびプロシージャでは、Lempel-Ziv圧縮アルゴリズムを使用してデータを圧縮します。
構文
次のファンクションは、RAW
を入力として使用し、圧縮して、圧縮後のRAW
の結果とメタデータを戻します。
UTL_COMPRESS.LZ_COMPRESS ( src IN RAW, quality IN BINARY_INTEGER DEFAULT 6) RETURN RAW;
次のファンクションは、BLOB
を入力として使用し、圧縮して、圧縮後のデータの一時BLOBを戻します。
UTL_COMPRESS.LZ_COMPRESS ( src IN BLOB, quality IN BINARY_INTEGER DEFAULT 6) RETURN BLOB;
次のプロシージャは、圧縮後のデータを、圧縮後のデータ・サイズにトリミングした既存のBLOB(dst)に戻します。
UTL_COMPRESS.LZ_COMPRESS ( src IN BLOB, dst IN OUT NOCOPY BLOB, quality IN BINARY_INTEGER DEFAULT 6);
次のファンクションは、圧縮後のデータの一時BLOB
を戻します。
UTL_COMPRESS.LZ_COMPRESS ( src IN BFILE, quality IN BINARY_INTEGER DEFAULT 6) RETURN BLOB;
次のプロシージャは、圧縮後のデータを、圧縮後のデータ・サイズにトリミングした既存のBLOB(dst)に戻します。
UTL_COMPRESS.LZ_COMPRESS ( src IN BFILE, dst IN OUT NOCOPY BLOB, quality IN BINARY_INTEGER DEFAULT 6);
パラメータ
表256-4 LZ_COMPRESSファンクションおよびプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
圧縮するデータ( |
|
圧縮したデータを戻す宛先。 |
|
1から9の範囲の整数。1は高速圧縮、9は最も効率のよい圧縮を指定します。デフォルトは6です。 |
使用上のノート
-
quality
は、オプションの圧縮チューニング値です。UTL_COMPRESS
の使用時に、速度と圧縮品質の関係(サイズ縮小の割合)を選択できます。圧縮速度を速くすると、データの圧縮率が低くなります。圧縮速度を遅くすると、データの圧縮率が高くなります。有効な値は1から9で、1が最も速く、9が最も遅くなります。qualityのデフォルト値は6です。
256.4.3 LZ_COMPRESS_ADDプロシージャ
このプロシージャは、1つの圧縮データを追加します。
構文
UTL_COMPRESS.LZ_COMPRESS_ADD ( handle IN BINARY_INTEGER, dst IN OUT NOCOPY BLOB, src IN RAW);
パラメータ
表256-5 LZ_COMPRESS_ADDプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
ピース単位の圧縮コンテキストへのハンドル。 |
|
圧縮したデータを格納するために、 |
|
圧縮する入力データ。 |
例外
-
invalid_handle
- 範囲外であるため無効か、ハンドルがオープンではありません。 -
invalid_argument
- handle、srcまたはdstの値がNULL
であるか、dst
の値が無効です。
256.4.4 LZ_COMPRESS_CLOSE
このプロシージャは、ピース単位の圧縮操作をクローズして終了します。
構文
UTL_COMPRESS.LZ_COMPRESS_CLOSE ( handle IN BINARY_INTEGER, dst IN OUT NOCOPY BLOB);
パラメータ
表256-6 LZ_COMPRESS_CLOSEプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
ピース単位の圧縮コンテキストへのハンドル。 |
|
圧縮したデータを格納するために、 |
例外
-
invalid_handle
- 範囲外であるため無効か、ハンドルが初期化されていません。 -
invalid_argument
- handle、dst
の値がNULLであるか、dst
の値が無効です。
256.4.5 LZ_COMPRESS_OPEN
このファンクションは、圧縮状態とデータを保持するピース単位のコンテキストを初期化します。
構文
UTL_COMPRESS.LZ_COMPRESS_OPEN ( dst IN OUT NOCOPY BLOB, quality IN BINARY_INTEGER DEFAULT 6) RETURN BINARY_INTEGER;
パラメータ
表256-7 LZ_COMPRESS_OPENファンクションのパラメータ
パラメータ | 説明 |
---|---|
|
圧縮したデータを格納するためにユーザーが提供するLOB。 |
|
結果としての圧縮出力の速度と効率の関係。
|
戻り値
初期化されたピース単位の圧縮コンテキストへのハンドル。
例外
-
invalid_handle
- ハンドルが無効か、オープンしているハンドルが多すぎます。 -
invalid_argument
-dst
の値がNULL
であるか、qualityの指定が無効です。
使用上のノート
次の場合には、オープンしているハンドルをLZ_COMPRESS_CLOSE
でクローズしてください。
-
ピース単位の圧縮が完了したとき
-
処理の途中で例外が発生したとき
クローズしないとハンドルがリークします。
256.4.6 LZ_UNCOMPRESSファンクションおよびプロシージャ
このプロシージャは、RAW
、BLOB
またはBFILE
で圧縮された文字列を入力として使用し、有効な圧縮値であることを検証し、Lempel-Ziv圧縮アルゴリズムを使用して圧縮を解除して、圧縮を解除したRAWまたはBLOB
の結果を戻します。
構文
次のファンクションは、圧縮解除後のデータをRAW
として戻します。
UTL_COMPRESS.LZ_UNCOMPRESS( src IN RAW) RETURN RAW;
次のファンクションは、圧縮解除後のデータを一時BLOB
として戻します。
UTL_COMPRESS.LZ_UNCOMPRESS( src IN BLOB) RETURN BLOB;
次のプロシージャは、圧縮解除後のデータを既存のBLOB
(dst
)に戻します。BLOBは圧縮解除後のデータ・サイズにトリミングされます。
UTL_COMPRESS.LZ_UNCOMPRESS( src IN BLOB, dst IN OUT NOCOPY BLOB);
次のファンクションは、圧縮解除後のデータの一時BLOBを戻します。
UTL_COMPRESS.LZ_UNCOMPRESS( src IN BFILE) RETURN BLOB;
次のプロシージャは、圧縮解除後のデータを既存のBLOB
(dst
)に戻します。元のdst
のデータは上書きされます。
UTL_COMPRESS.LZ_UNCOMPRESS( src IN BFILE, dst IN OUT NOCOPY BLOB);
パラメータ
表256-8 LZ_UNCOMPRESSファンクションおよびプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
圧縮したデータ。 |
|
圧縮解除したデータを戻す宛先。 |
256.4.7 LZ_UNCOMPRESS_EXTRACTプロシージャ
このプロシージャは、1つの圧縮解除データを抽出します。
構文
UTL_COMPRESS.LZ_UNCOMPRESS_EXTRACT( handle IN BINARY_INTEGER, dst OUT NOCOPY RAW);
パラメータ
表256-9 LZ_UNCOMPRESS_EXTRACTファンクションのパラメータ
パラメータ | 説明 |
---|---|
|
ピース単位の圧縮解除コンテキストへのハンドル。 |
|
圧縮解除したデータ。 |
例外
-
no_data_found
- 圧縮解除が終了しました。 -
invalid_handle
- 範囲外であるため無効か、ハンドルが初期化されていません。 -
invalid_argument
- handleの値がNULLです。
256.4.8 LZ_UNCOMPRESS_OPENファンクション
このファンクションは、圧縮解除状態とデータを保持するピース単位のコンテキストを初期化します。
構文
UTL_COMPRESS.LZ_UNCOMPRESS_OPEN( src IN BLOB) RETURN BINARY_INTEGER;
パラメータ
表256-10 LZ_UNCOMPRESS_OPENファンクションのパラメータ
パラメータ | 説明 |
---|---|
|
圧縮解除する入力データ。 |
戻り値
初期化されたピース単位の圧縮コンテキストへのハンドル。
例外
-
invalid_handle
- ハンドルが無効か、オープンしているハンドルが多すぎます。 -
invalid_argument
-src
の値がNULL
です。
使用上のノート
次の場合には、オープンしているハンドルをLZ_UNCOMPRESS_CLOSE
でクローズしてください。
-
ピース単位の圧縮解除が完了したとき
-
処理の途中で例外が発生したとき
クローズしないとハンドルがリークします。
256.4.9 LZ_UNCOMPRESS_CLOSEプロシージャ
このプロシージャは、ピース単位の圧縮解除をクローズして終了します。
構文
UTL_COMPRESS.LZ_UNCOMPRESS_CLOSE( handle IN BINARY_INTEGER);
パラメータ
表256-11 LZ_UNCOMPRESS_CLOSEプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
ピース単位の圧縮解除コンテキストへのハンドル。 |
例外
-
invalid_handle
- 範囲外であるため無効か、ハンドルが初期化されていません。 -
invalid_argument
- handleの値がNULL
です。