ステートメント・ハンドルの割り振り
ステートメント・ハンドルとは、SQL ステートメント を記述し、その実行をトラッキングするデータ・オブジェクトのことを言い ます。ステートメント・ハンドルを割り振ってはじめて、ステートメントを実行することができます。
SQLAllocHandle() (HandleType を SQL_HANDLE_STMT に設定) は、ステートメント・ハンドルを割り振って SQL ステートメントを説明します。 SQL ステートメントの記述の中には、ステートメント属性、SQL ステートメント・テキスト、 動的パラメーター、カーソル情報、動的引数と列のバインド、結果の値、 および状況情報などの情報が含まれています (これらは後で説明します)。 それぞれのステートメント・ハンドルは、そのハンドルが記述するステートメントと接続を 関連付けています。
デフォルトでは、一度に割り当てることができるステートメント・ハンドル
の最大数は、常にアプリケーションのヒープ・サイズによって制限されます。ただし、実際に使用できるステートメント・ハンドルの最大数は、Db2® ODBC により定義されます。
表 1 に、それぞれの分離レベルごとに Db2 ODBC で許される
ステートメント・ハンドルの数が示されています。アプリケーションがこの限界を超えると、
SQLPrepare() および SQLExecDirect() は、
SQLSTATE HY014 を戻します。
| 分離レベル | 保留なし | 保留あり | 合計 |
|---|---|---|---|
| カーソル固定 | 296 | 254 | 550 |
| コミットなし | 296 | 254 | 550 |
| 反復可能読み取り | 296 | 254 | 550 |
| 読み取り固定 | 296 | 254 | 550 |
| 非コミット読み取り | 296 | 254 | 550 |