LOB ロケーターの使用
LOB ロケーターによって、データベース・サーバーで LOB 値を識別し、取り扱えます。 また、これによって LOB 値の一部分をアプリケーション・メモリーに取り出すこともできます。
ロケーターとは実行時の概念です。 ロケーターは持続するタイプではなく、データベースにも保管されません。 LOB ロケーターは、概念的には、単純なトークン値 (ポインターによく似ている) であり、 データベース内のより大きな LOB 値を参照するのに使用します。LOB ロケーター値は、(特に指定のない 限り) その値を作成したトランザクションを越えてまで持続しません。
ロケーターは、LOB 値を参照しますが、それは LOB 値が存在する物理的なロケーション (また は、アドレス) ではありません。表にある元の LOB 値が変更されても、ロケーターが参照する LOB 値は 変わりません。 ロケーターで操作を行った場合も、表にある元の LOB 値がこれらの操作によって同じように 変わることはありません。LOB ロケーターで行う操作結果をマテリアライズするには、データベース・サーバー上の ロケーション、またはアプリケーション内の変数に、これらの操作結果を保管する必要があります。
- SQL_C_BLOB_LOCATOR - BLOB データの場合
- SQL_C_CLOB_LOCATOR - CLOB データの場合
- SQL_C_DBCLOB_LOCATOR - DBCLOB データの場合
SQLBindCol() および SQLFetch() を呼び出すか、SQLGetData() を呼び出して LOB 値に関連した LOB ロケーターを取り出してアプリケーション変数に入れます。その後、以下の Db2 ODBC 関数をそのロケーターに適用します。
- SQLGetLength() -- LOB ロケーターが表すストリングの長さを戻します。
- SQLGetPosition() -- LOB ロケーターが表すソース・ストリング内の検索ストリングの位置を戻します。LOB ロケーターは、検索ストリングとソース・ストリングの両方を表すことができます。
- バインドされた LOB 列を該当する C ロケーター・タイプにフェッチします。
- SQLGetSubString() を呼び出し、サブストリングをロケーターとして取り出すように指定します。
- バインドされていない LOB 列で SQLGetData() を呼び出し、該当する C ロケーター・タイプを指定します。C ロケーター・タイプは、LOB 列と一致している必要があります。一致していない場合は、 エラーが生じます。
また、LOB ロケーターを使用すると、データをアプリケーション・メモリーに取り出してからサーバー にデータを送り戻すことをせずに、サーバーで LOB データを移動することもできます。
INSERT INTO TABLE4A
VALUES(1,CAST(? AS CLOB(2K)) CONCAT CAST(? AS CLOB(3K)))
FREE LOCATOR ステートメントを用いて、トランザクションの終了前に、 ロケーターを明示的に解放することができます。HOLD LOCATOR ステートメントを用いて、作業単位を 越えてロケーターを保存することができます。 これらのステートメントは、以下の構文を用いて実行します。
.-,-------------. V | >>-FREE LOCATOR----host_variable-+-----------------------------><
.-,-------------. V | >>-HOLD LOCATOR----host_variable-+-----------------------------><
FREE LOCATOR SQL ステートメントまたは HOLD LOCATOR SQL ステートメントを動的に準備できなくても、Db2 ODBC は、SQLPrepare() および SQLExecDirect() の中で、これらのステートメントを受け入れます。 LOB ロケーター値を含んでいるアプリケーション変数を、これらの SQL ステートメントが アクセスできるホスト変数に変換できるようにするために、これらのステートメントの中でパラメーター・マーカーを 使用します。SQLPrepare() または SQLExecDirect() を呼び出す前に、データ・タイプ引数に適切な SQL と C のシンボリック・データ・タイプを設定して SQLBindParameter() を呼び出します。この SQLBindParameter() の呼び出しによって、ロケーター値が入ったアプリケーション変数がパラメーター・マーカーにホスト変数として渡されます。
ロケーターに関連した LOB ロケーターおよび関数 (SQLGetSubString()、SQLGetPosition()、および SQLGetLength() 関数など) は、ラージ・オブジェクトをサポートしていない Db2 サーバーに接続する場合は、使用できません。接続が LOB をサポートするかどうかを判別するには、関数タイプを SQL_API_SQLGETSUBSTRING に指定して SQLGetFunctions() を呼び出します。pfExists 出力引数が SQL_TRUE を戻す場合は、現行接続は LOB をサポートして います。pfExists 出力引数が SQL_FALSE を戻す場合は、現行接続は LOB をサポートしていません。
LOB データを結果セットから取得するときにロケーターを使用するアプリケーションでは、LIMITEDBLOCKFETCH 初期化キーワードを 0 に設定します。
その他の値に設定した場合、データのフェッチ後に SQLGetData() 関数を使用して LOB ロケーターを取り出し、アプリケーションの変数に入れようとすると、関数呼び出しは失敗します。
