照会ステートメントの処理中に、
アプリケーションは診断検査も実行する必要があります。
このタスクについて
SQLGetData() を使用して取り出すよりも、列をバインドした方が、一般的にはアプリケーションのパフォーマンスは良くなります。
ただし、アプリケーションでは、一度に取り出しで処理できる
長データの量に制限がある可能性があります。 このような制限が考えられる場合は、SQLGetData() の方が良い選択と言えます。手順
ODBC アプリケーションで照会ステートメントを処理するには、次のようにします。
- 実行済み、または準備済みのステートメントを分析して、列の数、タイプ、長さなど、結果セットの構造を記述します。 SQL ステートメントがアプリケーション
によって生成された場合は、このステップは
必要ない場合もあります。その理由は、アプリケーションは結果セットの構造と各列の
データ・タイプを認識している可能性があるためです。
結果セット全体の構造が判明している場合、とくに、結果セットが非常に多くの列を含んでいる
場合は、Db2® ODBC に記述子情報を与えておいた方がよいでしょう。これによって、Db2 ODBC がサーバー
から情報を取り出す必要がなくなるため、ネットワーク・トラフィックを削減することができます。
SQL ステートメントが実行時に生成された場合は (例えば、ユーザーの入力によって)、
アプリケーションは列の数、各列のタイプ、およびおそらく結果セット内の各列の名前を
照会する必要があります。
この情報は、ステートメントの準備の後または実行の後で、SQLNumResultCols() および SQLDescribeCol() (または SQLColAttribute()) を呼び出すと入手可能です。
- オプション: データを受信するためにアプリケーション変数を列にバインドするには、次の SQLFetch() の呼び出し時に、列データを直接アプリケーション変数の中に取り込みます。 取り込まれるそれぞれの列ごとに、アプリケーションは SQLBindCol() を
呼び出して、アプリケーション変数を結果セットの列にバインドします。アプリケーションは、ステップ 1 で得られた情報を使用して、
アプリケーション変数の C データ・タイプを判別し、列の値が占有できる最大のストレージを
割り振ることができます。SQLBindParameter() を使用して変数がパラメーター・マーカーに
バインドされるのと同じように、列が据え置き引数にバインドされます。この場合、SQLFetch() が呼び出されるときにデータはこれらの保管場所に書き込まれるため、変数は据え置き出力引数となります。
アプリケーションは、長いデータの列を小さく分けて取り出す必要がある場合と同じように、
いずれの列もバインドしない場合には、SQLGetData() を使用することができます。
バインドされる列とアンバインドされる列がある場合は、SQLBindCol() と SQLGetData() の両方の技法を
組み合わせることができます。
アプリケーションは、据え置き出力フィールドに使用される変数を結果セットの列にバインドした時点から、
Db2 ODBC が据え置き出力フィールドにデータを書き込む時点までの間に、割り振り解除または廃棄を
行ってはなりません。
- SQLFetch() を呼び出して、結果セットの最初または次の行をフェッチします。 バインドされた列があれば、アプリケーション変数が更新されます。また、結果セットの
複数行を配列の中にフェッチするアプリケーションを作成することも可能です。
SQLBindCol() の呼び出しのときに指定されたデータ・タイプでデータ変換が指示されている場合は、SQLFetch() が呼び出される際に変換が生じます。
- オプション: SQLGetData() を呼び出して、以前にバインドされていない列を取り込みます。
SQLBindCol() の場合と同様に、アプリケーション変数のターゲット C データ・タイプを指定して、データ変換をこの時点で指示することもできます。
結果セットの特定の列をアンバインドするには、アプリケーション変数の引数 (rgbValue) で NULL ポインター指定の SQLBindCol() を使用します。一度ですべての列をアンバインドするには、SQLFreeHandle() をステートメント・ハンドル
で呼び出します。