ODBC 限定ブロック・フェッチ

Db2® ODBC ドライバーは、限定ブロック・フェッチを使用して、ローカルの Db2 for z/OS® サーバーの FETCH 操作のパフォーマンスを向上させることができます。

限定ブロック・フェッチを使用すると、ローカルのDb2 for z/OSサーバーは、SQL 照会によって取得される行を、照会バッファー内の行のブロックにグループ化します。 Db2 ODBC ドライバーは、これらの行のブロックを照会バッファーから取得します。 SQLFetch()、SQLExtendedFetch()、または SQLFetchScroll() 関数を使用して、大規模な結果セットから単一行フェッチまたは複数行フェッチを実行するアプリケーションは、限定ブロック・フェッチによってメリットを得ることができます。 多数の行を一度に取得する方が、少数の行を複数回で取得するよりもパフォーマンスを改善することができます。

限定ブロック・フェッチは、アプリケーションに変更を加えずに使用可能にすることができます。 限定ブロック・フェッチを使用可能にするには、以下のようにします。
  • LIMITEDBLOCKFETCH 初期化キーワードを 1 に設定します。

    1 がデフォルト値です。

  • デフォルト値の 32767 バイトで十分なパフォーマンスを得られない場合は、QUERYDATASIZE 初期化パラメーターを調整して、FETCH 処理中に 1 回で転送されるバイト数を設定します。 一般的に、QUERYDATASIZE の値を大きくすると、データ・ソースとのやり取りが少なくなり、パフォーマンスを改善することができます。

限定ブロック・フェッチは、データを更新または削除しない非両方向スクロール・カーソルでのみ有効です。

変更の始まりLOB データを結果セットから取得する場合にロケーターを使用するアプリケーションでは、LIMITEDBLOCKFETCH を 0 に設定します。 その他の値に設定した場合、データのフェッチ後に SQLGetData() 関数を使用して LOB ロケーターを取り出し、アプリケーションの変数に入れようとすると、関数呼び出しは失敗します。変更の終わり

変更の始まりまた、SQL_C_BINARYXML データ・タイプを使用するアプリケーションでは、LIMITEDBLOCKFETCH を 0 に設定します。 その他の値に設定した場合、SQLGetData() 関数を使用して XML データを取得し、LIMITEDBLOCKFETCH を 1 に設定しようとすると、関数呼び出しは失敗します。変更の終わり

限定ブロック・フェッチを使用可能にすると、アプリケーションに返されるデータは、ソース表にコミットされたデータを反映していない場合があります。 例えば、限定ブロック・フェッチが使用可能で、アプリケーションが SQLFetch() を発行して結果セットから行をフェッチするとします。 Db2 ODBC は、行のブロックを取得して保管します。 別のアプリケーションが同時に後続のすべての行を表から削除するとします。 アプリケーションが次に SQLFetch() 呼び出しを実行すると、保管された行のブロックから、後続の行を取得します。 ただし、これらの行は、すでに表に存在しません。 アプリケーションが他のユーザーによって更新される表からデータをフェッチする場合、またはアプリケーションがセーブポイントを使用して ROLLBACK TO SAVEPOINT を発行し、トランザクションを管理する場合は、限定ブロック・フェッチを使用不可にしてください。