結果セットを戻すストアード・プロシージャーのプログラミング
一般には、結果セットを Db2® ODBC アプリケーションに戻すストアード・プロシージャーを作成して、さまざまなアクションを行います。
以下のアクションを実行できます。
- ストアード・プロシージャーが戻す各結果セットごとに、 カーソルを WITH RETURN オプションで宣言し、結果セットでカーソルをオープンし (すなわち、 照会を実行する)、さらにプロシージャーを終了した後もカーソルをオープンのままにしておきます。
- 終了後もそのままオープン状態になっているカーソルごとに結果セットを戻します。戻す順序は、 対応するカーソルをプロシージャーがオープンした順序です。
- 未読の行のみを Db2 ODBC クライアント・アプリケーションに渡して戻します。
例えば、あるカーソルの結果セットが 500 行あり、ストアード・プロシージャー は、終了前にそのうちの 150 行を読み取っていた場合、行 151 から行 500 のみを戻します。 この性質を利用すると、結果セット内の初期に読み込んだ複数行を フィルターに掛けて除外してから、クライアント・アプリケーションに戻すことができます。
さらに具体的に言うと、結果セットを戻す Db2 ODBC ストアード・プロシージャーを
作成する場合は、アプリケーションに以下の手順を組み込む必要があります。
- SQLExecute() または SQLExecDirect() を出して、カーソルをオープンする照会を実行します。ストアード・プロシージャーでは、Db2 ODBC はカーソルを WITH RETURN オプションを用いて宣言します。
- オプションとして、SQLFetch() を出して、フィルターを通す必要のある行を結果セットから読み取ります。
- SQLDisconnect()、SQLFreeHandle() (HandleType を SQL_HANDLE_DBC に設定)、および SQLFreeHandle() (HandleType を SQL_HANDLE_ENV に設定) を発行しストアード・プロシージャーを終了します。この終了によってステートメント・ハンドル、および対応するカーソルは、有効な状態のまま になります。