結果セットを戻すストアード・プロシージャーのプログラミング

一般には、結果セットを Db2® ODBC アプリケーションに戻すストアード・プロシージャーを作成して、さまざまなアクションを行います。

以下のアクションを実行できます。
  • ストアード・プロシージャーが戻す各結果セットごとに、 カーソルを WITH RETURN オプションで宣言し、結果セットでカーソルをオープンし (すなわち、 照会を実行する)、さらにプロシージャーを終了した後もカーソルをオープンのままにしておきます。
  • 終了後もそのままオープン状態になっているカーソルごとに結果セットを戻します。戻す順序は、 対応するカーソルをプロシージャーがオープンした順序です。
  • 未読の行のみを Db2 ODBC クライアント・アプリケーションに渡して戻します。

    例えば、あるカーソルの結果セットが 500 行あり、ストアード・プロシージャー は、終了前にそのうちの 150 行を読み取っていた場合、行 151 から行 500 のみを戻します。 この性質を利用すると、結果セット内の初期に読み込んだ複数行を フィルターに掛けて除外してから、クライアント・アプリケーションに戻すことができます。

さらに具体的に言うと、結果セットを戻す Db2 ODBC ストアード・プロシージャーを 作成する場合は、アプリケーションに以下の手順を組み込む必要があります。
  1. SQLExecute() または SQLExecDirect() を出して、カーソルをオープンする照会を実行します。ストアード・プロシージャーでは、Db2 ODBC はカーソルを WITH RETURN オプションを用いて宣言します。
  2. オプションとして、SQLFetch() を出して、フィルターを通す必要のある行を結果セットから読み取ります。
  3. SQLDisconnect()、SQLFreeHandle() (HandleType を SQL_HANDLE_DBC に設定)、および SQLFreeHandle() (HandleType を SQL_HANDLE_ENV に設定) を発行しストアード・プロシージャーを終了します。この終了によってステートメント・ハンドル、および対応するカーソルは、有効な状態のまま になります。
SQLFreeHandle() (HandleType を SQL_HANDLE_STMT に設定) または SQLCloseCursor() を発行しないでください。ステートメント・ハンドルを解放しない場合、あるいはそのハンドルでカーソルを明示的に クローズした場合、結果セットを戻すためにそのカーソルはオープン状態のままとなります。 ストアード・プロシージャーが終了する前にカーソルをクローズすると、ローカル・カーソルになります。 ストアード・プロシージャーが終了してもカーソルをオープンのままにしておくと、 ストアード・プロシージャーはクライアント・アプリケーションに照会結果セット (複数結果セットとも 呼ばれる) を戻します。