Db2® ODBC アプリケーションでの相対スクロールおよび絶対スクロール
両方向スクロール・カーソルを使用する場合は、SQLFetchScroll() を呼び出して、カーソルを移動し行をフェッチします。フェッチする行の集合を行セット と言います。
SQLFetchScroll() 関数は相対スクロール (次の行への移動、前の行への移動、n 行だけ前方または後方に移動
) および絶対スクロール (最初の行への移動、最後の行への移動、行番号 n への移動) をサポートします。
SQLFetchScroll() 呼び出しの FetchOrientation パラメーターで、スクロールのタイプを決定します。可能な値は、以下のとおりです。
- SQL_FETCH_NEXT
- SQL_FETCH_PRIOR
- SQL_FETCH_FIRST
- SQL_FETCH_LAST
- SQL_FETCH_ABSOLUTE
- SQL_FETCH_RELATIVE
SQL_FETCH_ABSOLUTE の場合、FetchOffset パラメーターはカーソルの移動先の行を決定します。SQL_FETCH_RELATIVE の場合、FetchOffset パラメーターは、カーソルを移動する行数を決定します。
次の図には、SQLFetchScroll() 呼び出しにさまざまな FetchOffset と FetchOrientation パラメーター値を指定した場合の結果セット内のカーソルがどのように移動するかを示します。この例では、行セット・サイズは 3 で、元のカーソル位置は、結果セットの最後から 3 行にあります。

行セット全体にデータが含まれていると想定することはできません。アプリケーションは、それぞれのフェッチ後、行セットのサイズを検査して、行セットに完全な行セットが含まれているかどうか判別します。例えば、行セットを 10 に設定し、FetchOrientation 値に SQL_FETCH_ABSOLUTE および FetchOffset 値に -3 を使用して、SQLFetchScroll() 呼び出すとします。次の図に示すように、この関数呼び出しは、結果セットの終りから 3 行にカーソル位置を設定し、10 行フェッチするよう試みます。

フェッチ後、行セットの最初の 3 行のみに、意味のあるデータが含まれているので、アプリケーションではそれらの 3 行のみを使用してください。