ステートメント・ハンドルの割り振り

ステートメント・ハンドルとは、SQL ステートメント を記述し、その実行をトラッキングするデータ・オブジェクトのことを言い ます。ステートメント・ハンドルを割り振ってはじめて、ステートメントを実行することができます。

SQLAllocHandle() (HandleType を SQL_HANDLE_STMT に設定) は、ステートメント・ハンドルを割り振って SQL ステートメントを説明します。 SQL ステートメントの記述の中には、ステートメント属性、SQL ステートメント・テキスト、 動的パラメーター、カーソル情報、動的引数と列のバインド、結果の値、 および状況情報などの情報が含まれています (これらは後で説明します)。 それぞれのステートメント・ハンドルは、そのハンドルが記述するステートメントと接続を 関連付けています。

デフォルトでは、一度に割り当てることができるステートメント・ハンドル の最大数は、常にアプリケーションのヒープ・サイズによって制限されます。ただし、実際に使用できるステートメント・ハンドルの最大数は、Db2® ODBC により定義されます。 表 1 に、それぞれの分離レベルごとに Db2 ODBC で許される ステートメント・ハンドルの数が示されています。アプリケーションがこの限界を超えると、 SQLPrepare() および SQLExecDirect() は、 SQLSTATE HY014 を戻します。
表 1. 一時点で割り振られるステートメント・ハンドルの最大数
分離レベル 保留なし 保留あり 合計
カーソル固定 296 254 550
コミットなし 296 254 550
反復可能読み取り 296 254 550
読み取り固定 296 254 550
非コミット読み取り 296 254 550