ヘッダーをスキップ
Oracle Database SecureFilesおよびラージ・オブジェクト開発者ガイド
11gリリース1（11.1）
E05675-02
  目次
目次		 索引
索引
戻る
戻る 		 次へ
次へ		  

2 LOBの作業

この章では、アプリケーションでLOBを使用する場合に十分に理解しておく必要のあるLOBの使用方法とセマンティクスについて説明します。また、LOBを使用するための様々な技法についても説明します。

この章での永続LOBに関するほとんどの説明は、既存の表にあるLOBを扱うことを前提としています。通常、LOB列を含む表の作成作業は、データベース管理者が行います。


関連項目:

この章の内容は次のとおりです。

LOB列のステータス

LOB列のセルにアクセスするときに使用する手法は、そのセルの状態に応じて異なります。LOB列のセルの状態は、次のいずれかです。

LOBを含む行のロック

LOBを含む行をロックして、トランザクション中に他のデータベース・ユーザーがLOBに書き込むのを防止できます。LOBを含む行をロックするには、行の選択時にFOR UPDATE句を指定します。行をロックすると、トランザクションを終了するまで他のユーザーはそのLOBをロックまたは更新できません。

LOBのオープンおよびクローズ

LOB APIには、LOBインスタンスを明示的にオープンおよびクローズできる操作が組み込まれています。永続LOBインスタンスは、BLOB、CLOB、NCLOBまたはBFILEなど、どの型の場合にもオープンおよびクローズできます。LOBをオープンすると、次の一方または両方の結果となります。

オープンしたLOBは、セッションのいずれかの時点でクローズする必要があります。これは、オープンしているLOBに対する唯一の要件です。LOBインスタンスがオープンしている間は、オープン時のモードで許可されている操作であれば、LOBに対して必要な数の操作を実行できます。


関連項目:

これらのAPIの使用方法の詳細は、「OPENおよびCLOSEインタフェースを使用した永続LOBのオープン」を参照してください。

LOBロケータとLOB値

LOB値にアクセスして変更するには、次の2つの方法があります。

LOB用データ・インタフェースの使用

OCIのLOB用データ・インタフェースを使用すると、CアプリケーションでCLOB列とBLOB列に対してバインド操作と定義操作を実行できます。これにより、次のように、LOBロケータを使用せずにLOB列にデータを挿入したり、LOB列からデータを選択できます。

  • LOB列に関連付けられているバインド変数を使用して、CLOBに文字データを挿入するか、BLOBにRAWデータを挿入します。

  • 定義操作を使用してアプリケーションで出力バッファを定義します。このバッファに、CLOBから選択された文字データまたはBLOBから選択されたRAWデータが保持されます。


    関連項目:

    LOBの他のデータ型への暗黙的な割当ての詳細は、第14章「永続LOB用のデータ・インタフェース」を参照してください。

LOBロケータを使用したLOB値へのアクセスと変更

データベースに格納されたLOBインスタンスの値には、LOBロケータ、つまりLOB値の位置への参照を介してアクセスできます。データベース表では、CLOB、BLOB、NCLOBおよびBFILE列にロケータのみが格納されます。LOBロケータとLOB値に関する注意事項は、次のとおりです。

  • LOB値にアクセスしたり操作するには、各種のLOB APIにLOBロケータを渡します。

  • LOBロケータは、同じ型の任意のLOBインスタンスに割り当てることができます。

  • 一時LOBまたは永続LOBの特性は、ロケータには影響しません。この2つの特性はLOBインスタンスにのみ適用されます。

LOBロケータとBFILEロケータ

LOB型のBLOB、CLOBおよびNCLOBのロケータとBFILE型のロケータでは、セマンティクスに次のような違いがあることに注意する必要があります。

LOB値の格納場所に関係なく、ロケータは初期化済LOB列の表の行に格納されます。単にロケータという場合は、LOBロケータとBFILEロケータの両方を指すことに注意してください。また、表からLOBを選択した場合、戻されるLOBは常に一時LOBです。一時LOBのロケータの使用方法の詳細は、「SQLファンクションから戻されるLOB」を参照してください。

print_media表

Oracle Databaseサンプル・スキーマPMのprint_media表は、このマニュアルの多数の例で使用されており、次のように定義されています。

CREATE TABLE print_media
    ( product_id        NUMBER(6)
    , ad_id             NUMBER(6)
    , ad_composite      BLOB
    , ad_sourcetext     CLOB
    , ad_finaltext      CLOB
    , ad_fltextn        NCLOB
    , ad_textdocs_ntab  textdoc_tab
    , ad_photo          BLOB
    , ad_graphic        BFILE
    , ad_header         adheader_typ
    ) NESTED TABLE ad_textdocs_ntab STORE AS textdocs_nestedtab;

関連項目:

print_mediaおよびそれに関連付けられた表とファイルの作成方法の詳細は、「1つ以上のLOB列を含む表の作成」 を参照してください。

ロケータを含めるためのLOB列の初期化

NULLのLOBインスタンスには、ロケータはありません。LOBインスタンスをLOB APIルーチンに渡す前に、そのインスタンスにロケータを含める必要があります。たとえば、行からNULLのLOBを選択できますが、そのインスタンスをPL/SQL DBMS_LOB.READプロシージャには渡せません。次の項では、永続LOB列を初期化する方法とBFILE列を初期化する方法について説明します。

永続LOB列の初期化

サポートされているプログラム環境（PL/SQL、OCI、OCCI、Pro*C/C++、Pro*COBOL、Visual Basic、JavaまたはOLEDB）を使用してデータを永続LOBに書き込む前に、LOB列およびLOB属性をNULL以外にする必要があります。つまり、ロケータを含める必要があります。

これは、BLOBに対してはEMPTY_BLOBファンクション、CLOBおよびNCLOBに対してはEMPTY_CLOBファンクションを使用して、INSERT文およびUPDATE文で永続LOBを空に初期化することによって行います。


注意:

SQLを使用すると、NULL値が含まれているLOB列にもデータを移入できます。


関連項目:

LOB列の初期化方法の詳細は、第5章「LOB記憶域」を参照してください。

EMPTY_BLOB()またはEMPTY_CLOB()ファンクションを実行すること自体では例外は発生しません。ただし、空に設定されたLOBロケータを使用して、PL/SQLのDBMS_LOBまたはOCI関数でLOB値に対してアクセスまたは操作すると、例外が発生します。

空のロケータを使用できるのは、INSERT文のVALUES句やUPDATE文のSET句などです。


関連項目:

  • CREATE DIRECTORYおよびBFILENAMEの使用方法の詳細は、「ディレクトリ・オブジェクト」を参照してください。

  • ディレクトリ・オブジェクトの作成方法の詳細は、『Oracle Databaseリファレンス』のCREATE DIRECTORY文の項を参照してください。

  • 『Oracle Database SQL言語リファレンス』のCREATE DIRECTORY文の項を参照してください。


注意:

文字列は、インスタンス用のデフォルトのキャラクタ・セットを使用して挿入されます。

INSERT文はPMのprint_media表において次の操作を実行します。

  • ad_sourcetextに文字列my Oracleを移入します。

  • ad_composite、ad_finaltextおよびad_fltextnを空の値に設定します。

  • ad_photoをNULLに設定します。

  • ad_graphicを、論理ディレクトリmy_directory_objectにあるmy_pictureファイルを指すように初期化します。

CREATE OR REPLACE DIRECTORY my_directory_object AS 'oracle/work/tklocal';
INSERT INTO print_media VALUES (1726, 1, EMPTY_BLOB(),
    'my Oracle', EMPTY_CLOB(), EMPTY_CLOB(),
    NULL, NULL, BFILENAME('my_directory_object', 'my_picture'), NULL);

同様に、print_media内のad_header列のLOB属性は、次に示すようにNULL、空、または文字/生のリテラルに初期化できます。

INSERT INTO print_media (product_id, ad_id, ad_header)
    VALUES (1726, 1, adheader_typ('AD FOR ORACLE', sysdate,
    'Have Grid', EMPTY_BLOB()));

関連項目:

BFILEの初期化

LOB APIを使用してBFILE値にアクセスする前に、BFILE列または属性をNULL以外にする必要があります。BFILENAMEファンクションを使用して、外部OSファイルを指すBFILE列を初期化できます。


関連項目:

BFILE列の初期化方法の詳細は、「BFILEへのアクセス」を参照してください。

LOBへのアクセス

LOBインスタンスにアクセスするには、次の方法があります。

SQLを使用したLOBへのアクセス

LOBデータ型を使用する列に対するサポートは、多数のSQLファンクションに組み込まれています。このサポートにより、SQLのセマンティクスを使用してSQLでLOB列にアクセスできます。ほとんどの場合は、VARCHAR2列に使用するのと同じSQLセマンティクスをLOB列に対して使用できます。


関連項目:

LOBに対するSQLセマンティクスのサポートの詳細は、第10章「SQLセマンティクスとLOB」を参照してください。

データ・インタフェースを使用したLOBへのアクセス

OCIやPL/SQLのLONG-to-LOB APIを使用すると、直接LOBを選択してCHARバッファまたはRAWバッファに移動できます。次のPL/SQLの例では、ad_finaltextがVARCHAR2バッファfinal_adに移動するように選択されています。

DECLARE
    final_ad VARCHAR(32767);
BEGIN
    SELECT ad_finaltext INTO final_ad FROM print_media
        WHERE product_id = 2056 and ad_id = 12001 ;
    /* PUT_LINE can only output up to 255 characters at a time  */
    ...
    DBMS_OUTPUT.PUT_LINE(final_ad);
    /* more calls to read final_ad */
    ...
END;

関連項目:

データ・インタフェースを使用してLOBにアクセスする方法の詳細は、第14章「永続LOB用のデータ・インタフェース」を参照してください。

ロケータ・インタフェースを使用したLOBへのアクセス

データベースで提供されるLOB APIにLOBロケータを渡すことで、LOBインスタンスにアクセスして操作できます。サポートされている各プログラム環境には、広範囲なLOB APIセットが用意されています。OCIの場合、LOBロケータはLOB値へのアクセスに使用されるロケータ・ポインタにマップされます。


注意:

OCIを含め、どの環境の場合も、LOB APIはLOB値を暗黙的に操作することに注意してください。LOBロケータの間接参照先へアクセスして操作する必要はありません。


関連項目:

LOBのルールと制限

この項では、LOBのルールと制限の詳細を説明します。

LOB列のルール

LOB列には次のルールと制限があります。

  • LOBは主キー列として指定できません。

  • Oracle DatabaseのリモートLOBに対するサポートは限定されています。リモートLOBは、次の3つの形式でサポートされています。

    1. AS SELECT形式での表の作成または挿入。

    CREATE TABLE t AS SELECT * FROM table1@remote_site;
INSERT INTO t SELECT * FROM table1@remote_site;
UPDATE t SET lobcol = (SELECT lobcol FROM table1@remote_site);
INSERT INTO table1@remote_site SELECT * FROM local_table;
UPDATE table1@remote_site SET lobcol = (SELECT lobcol FROM local_table);
DELETE FROM table1@remote_site <WHERE clause involving non_lob_columns>

    前述の例のように構造化された文の場合、SELECT構文のリストに使用できるのはスタンドアロンのLOB列のみです。

    2. スカラーを戻すリモートLOB上のファンクション。LOBパラメータを含み、スカラー・データ型を戻すSQLおよびPL/SQLファンクションがサポートされています。他のSQLファンクションとDBMS_LOB APIの場合、リモートのLOB列に対する使用はサポートされていません。たとえば、次の文はサポートされています。

    CREATE TABLE tab AS SELECT DBMS_LOB.GETLENGTH@dbs2(clob_col) len FROM tab@dbs2;
CREATE TABLE tab AS SELECT LENGTH(clob_col) len FROM tab@dbs2;

    ただし、次の文は、DBMS_LOB.SUBSTRがLOBを戻すため、サポートされていません。

    CREATE TABLE tab AS SELECT DBMS_LOB.SUBSTR(clob_col) from tab@dbs2;

    3. リモートLOB用のデータ・インタフェース。文字またはバイナリのバッファをリモートのCLOBまたはBLOBに挿入、およびリモートのCLOBまたはBLOBを選択して文字またはバイナリのバッファに挿入できます。次にPL/SQLの場合の例を示します。

    SELECT clobcol1, type1.blobattr INTO varchar_buf1, raw_buf2 FROM
   table1@remote_site;
INSERT INTO table1@remotesite (clobcol1, type1.blobattr) VALUES varchar_buf1,
   raw_buf2;
INSERT INTO table1@remotesite (lobcol) VALUES ('test');
UPDATE table1 SET lobcol = 'xxx';

    リモート表のLOBに関してサポートされているのは、これらの構文のみです。他の使用方法はサポートされていません。

  • クラスタには、キー列としてもキー列以外の列としても、LOBを含めることはできません。

  • 次のデータ構造は、一時インスタンスとしてのみサポートされます。この種のインスタンスはデータベース表に格納できません。

    • 任意のLOB型のVARRAY

    • LOB属性を持つオブジェクト型など、LOB型を含む任意の型のVARRAY

    • 任意のLOB型のANYDATA

    • LOB型を含む任意の型のANYDATA

  • 問合せのORDER BY句やGROUP BY句または集計ファンクションには、LOB列を指定できません。

  • SELECT...DISTINCT文やSELECT...UNIQUE文、または結合文には、LOB列を指定できません。ただし、列のオブジェクト型にその型で定義されたMAPファンクションまたはORDERファンクションが含まれている場合、SELECT...DISTINCT文、またはUNIONやMINUS集合演算子を使用する問合せには、オブジェクト型列のLOB属性を指定できます。

  • LOBセグメントの最初の（INITIAL）エクステントには、3つ以上のデータベース・ブロックを含める必要があります。

  • AFTER UPDATE DMLトリガーの作成時には、UPDATE OF句にLOB列を指定できません。

  • LOB列は索引キーの一部として指定できません。ただし、ドメイン索引の索引タイプ指定には、LOB列を指定できます。また、Oracle Textを使用すると、CLOB列に索引を定義できます。

  • INSERT...AS SELECT操作では、LOB列とLOB属性に最大4,000バイトのデータをバインドできます。

  • 表にLONG列とLOB列の両方がある場合、同一のSQL文でLONG列とLOB列の両方に4,000バイトを超えるデータをバインドすることはできません。ただし、LONG列またはLOB列のいずれか一方には、4,000バイトを超えるデータをバインドできます。


注意:

OCI関数またはDBMS_LOBパッケージを使用して、LOB列の値またはオブジェクト型列のLOB属性を変更した場合、AFTER UPDATE DMLトリガーを定義した表では、DMLトリガーが起動されません。


関連項目:

LOB操作の制限

その他の一般的なLOBの制限は、次のとおりです。

  • SQL*Loaderでは、LOBから読み取られたフィールドは句の引数として使用できません。「データをLOBにロードするためのデータベース・ユーティリティ」を参照してください。

  • 共有サーバー（マルチスレッド・サーバー）・モードでのBFILEのセッション移行はサポートされません。これは、オープンされたBFILEに対する操作を、共有サーバーへのコール終了後も継続できることを意味します。BFILE操作が含まれる共有サーバーのセッションは、1台の共有サーバーに限定され、サーバー間での移行はできません。

  • CLOB列に対する大/小文字を区別しない検索は、多くの場合成功しません。CLOB列に対して大/小文字を区別しない検索を行うには、たとえば次のようにします。

    ALTER SESSION SET NLS_COMP=LINGUISTIC;
ALTER SESSION SET NLS_SORT=BINARY_CI;
SELECT * FROM ci_test WHERE LOWER(clob_col) LIKE 'aa%';

    LOWER関数がないとSELECTは失敗します。Oracle Textでは、大/小文字を区別しない検索に対応しています。また、DBMS_LOB.INSTRを使用する方法もあります。第10章「SQLセマンティクスとLOB」を参照してください。

  戻る
戻る 		 次へ
次へ
  目次
目次		 索引
索引