ハンドル
ハンドルとは、Db2® ODBC によって制御されるデータ・オブジェクトを参照する変数のことです。初期化処理および終了処理には、 環境ハンドル、接続ハンドル、およびステートメント・ハンドルが必要です。
ハンドルを使用すると、グローバル変数あるいは データ構造 (IBM® 組み込み SQL インターフェースが使用する SQLDA または SQLCA など) を アプリケーションで管理する必要がなくなります。
Db2 ODBC では、以下の 3 つのハンドルを定義しています。
- 環境ハンドル
- 環境ハンドルとは、アプリケーションのグローバルな状態に関する 情報 (属性や接続など) が入っているデータ・オブジェクトのことです。 このハンドルは、SQLAllocHandle() (HandleType を SQL_HANDLE_ENV に設定) を呼び出すことによって割り振られ、SQLFreeHandle() (HandleType を SQL_HANDLE_ENV に設定) を 呼び出すことによって、解放されます。 接続ハンドルを割り当てる前に、環境ハンドルを割り当てる必要があります。
- 接続ハンドル
- 接続ハンドルとは、特定のデータ・ソースへの接続に関連した情報が入った
データ・オブジェクトのことを言います。これには、接続属性、一般状況情報、
トランザクション状況、および診断情報が含まれます。
それぞれの接続ハンドルは、SQLAllocHandle() (HandleType を SQL_HANDLE_DBC に設定) を
呼び出すことによって割り振られ、SQLFreeHandle() (HandleType を SQL_HANDLE_DBC に設定) を
呼び出すことによって解放されます。
1 つのアプリケーションを同時に複数のデータベース・サーバーに接続できます。 アプリケーションには、データベース・サーバーへのそれぞれの同時接続ごとに 1 つの 接続ハンドルが必要です。
ユーザーが接続ハンドルの数の限度を設定しているかどうかを判別する には、SQLGetInfo() を呼び出してください。
- ステートメント・ハンドル
- ステートメント・ハンドルとは、SQL ステートメント を記述し、その実行をトラッキングするデータ・オブジェクトのことを言い ます。SQLAllocHandle() を呼び出して、ステートメント・ハンドルを割り振ることができます。これはステートメントを実行する前に行う必要があります。
初期化タスクは、環境ハンドルと接続ハンドルの割り当ておよび初期化から構成されます。 終了タスクは、後でこのハンドルを解放します。 アプリケーションはその後、他の Db2 ODBC 関数を呼び出すときに、該当するハンドルを渡します。