照会 (SELECT、VALUES) ステートメントの処理

照会ステートメントの処理中に、 アプリケーションは診断検査も実行する必要があります。

このタスクについて

SQLGetData() を使用して取り出すよりも、列をバインドした方が、一般的にはアプリケーションのパフォーマンスは良くなります。 ただし、アプリケーションでは、一度に取り出しで処理できる 長データの量に制限がある可能性があります。 このような制限が考えられる場合は、SQLGetData() の方が良い選択と言えます。

手順

ODBC アプリケーションで照会ステートメントを処理するには、次のようにします。

  1. 実行済み、または準備済みのステートメントを分析して、列の数、タイプ、長さなど、結果セットの構造を記述します。 SQL ステートメントがアプリケーション によって生成された場合は、このステップは 必要ない場合もあります。その理由は、アプリケーションは結果セットの構造と各列の データ・タイプを認識している可能性があるためです。

    結果セット全体の構造が判明している場合、とくに、結果セットが非常に多くの列を含んでいる 場合は、Db2® ODBC に記述子情報を与えておいた方がよいでしょう。これによって、Db2 ODBC がサーバー から情報を取り出す必要がなくなるため、ネットワーク・トラフィックを削減することができます。

    SQL ステートメントが実行時に生成された場合は (例えば、ユーザーの入力によって)、 アプリケーションは列の数、各列のタイプ、およびおそらく結果セット内の各列の名前を 照会する必要があります。 この情報は、ステートメントの準備の後または実行の後で、SQLNumResultCols() および SQLDescribeCol() (または SQLColAttribute()) を呼び出すと入手可能です。

  2. オプション: データを受信するためにアプリケーション変数を列にバインドするには、次の SQLFetch() の呼び出し時に、列データを直接アプリケーション変数の中に取り込みます。 取り込まれるそれぞれの列ごとに、アプリケーションは SQLBindCol() を 呼び出して、アプリケーション変数を結果セットの列にバインドします。アプリケーションは、ステップ 1 で得られた情報を使用して、 アプリケーション変数の C データ・タイプを判別し、列の値が占有できる最大のストレージを 割り振ることができます。SQLBindParameter() を使用して変数がパラメーター・マーカーに バインドされるのと同じように、列が据え置き引数にバインドされます。この場合、SQLFetch() が呼び出されるときにデータはこれらの保管場所に書き込まれるため、変数は据え置き出力引数となります。

    アプリケーションは、長いデータの列を小さく分けて取り出す必要がある場合と同じように、 いずれの列もバインドしない場合には、SQLGetData() を使用することができます。 バインドされる列とアンバインドされる列がある場合は、SQLBindCol() と SQLGetData() の両方の技法を 組み合わせることができます。 アプリケーションは、据え置き出力フィールドに使用される変数を結果セットの列にバインドした時点から、 Db2 ODBC が据え置き出力フィールドにデータを書き込む時点までの間に、割り振り解除または廃棄を 行ってはなりません。

  3. SQLFetch() を呼び出して、結果セットの最初または次の行をフェッチします。 バインドされた列があれば、アプリケーション変数が更新されます。また、結果セットの 複数行を配列の中にフェッチするアプリケーションを作成することも可能です。

    SQLBindCol() の呼び出しのときに指定されたデータ・タイプでデータ変換が指示されている場合は、SQLFetch() が呼び出される際に変換が生じます。

  4. オプション: SQLGetData() を呼び出して、以前にバインドされていない列を取り込みます。

    SQLBindCol() の場合と同様に、アプリケーション変数のターゲット C データ・タイプを指定して、データ変換をこの時点で指示することもできます。

    結果セットの特定の列をアンバインドするには、アプリケーション変数の引数 (rgbValue) で NULL ポインター指定の SQLBindCol() を使用します。一度ですべての列をアンバインドするには、SQLFreeHandle() をステートメント・ハンドル で呼び出します。