詳細な説明の開始
この図は、アプリケーションのトランザクション処理タスクで呼び出す関数の
共通の順序を示したフローチャートです。
これらの順序は、主に 2 つの部分から成っています。SQL ステートメントの準備と実行、
および SQL ステートメントが実行するアクションの処理の 2 つです。
次の表で示す関数の順序の 1 つに従って、ステートメントを準備し、実行します。
| 順序 A |
順序 A の説明 |
| SQLAllocHandle() |
ステートメントを割り振る。 |
| SQLPrepare() |
ステートメントを準備する。 |
| SQLBindParameter() |
準備済み SQL ステートメントにパラメーター・マーカーがあれば、バインドする。 |
| SQLExecute() |
ステートメントを実行する。 |
| 順序 B |
順序 B の説明 |
| SQLAllocHandle() |
ステートメントを割り振る。 |
| SQLBindParameter() |
準備済み SQL ステートメントにパラメーター・マーカーがあれば、ステートメント・ハンドルでバインドする。 |
| SQLExecDirect() |
ステートメントを直接実行する。 |
SQL ステートメントを準備し、実行した後、ステートメントが行う
アクションを処理します。この図は、以下の SQL アクションのタイプを処理する関数の順序を表しています。
- 照会結果の生成 (SELECT および VALUES)
- データの更新 (UPDATE、DELETE、および INSERT)
- その他のデータ定義ステートメント (ALTER、CREATE、DROP、REVOKE、および SET)
照会結果を生成する SQL ステートメントの場合、通常は、次の表で示す関数の順序を使用します。
表の中のそれぞれの行は、オプションの関数呼び出しまたは関数呼び出し間の選択を表しています。
これらの関数呼び出しは、アプリケーションに組み込む順序で示されています。
| 関数呼び出し |
使用法 |
説明 |
| SQLNumResultCols() |
オプション |
結果セットの列の数を見つけます。
この数が分かっている場合は、この関数呼び出しを除去できます。 |
| SQLDescribeCol() または SQLColAttribute() |
オプション |
結果セットの列の SQL データ・タイプを見つけます。
列に含まれるデータのタイプが分かっているのではない限り、それぞれの列ごとに以下の関数の 1 つを
呼び出します。 |
| SQLBindCol() または SQLFetch() |
必要な選択 |
結果行を取り出す場合は、結果セットのそれぞれの列ごとに SQLBindCol() を呼び出します。一度に 1 つの値のデータを取り出す場合は、SQLFetch() を呼び出します。 |
| SQLFetch()、または SQLFetch() が続く SQLGetData() |
必要な選択 |
前のステップで SQLBindCol() を使用した場合は、
取り出すそれぞれの行ごとに SQLFetch() を呼び出します。列を SQLBindCol() でバインドしなかった場合は、所定の行で受け取るそれぞれの
値ごとに、SQLGetData() を呼び出します。SQLGetData() を使用して結果を取り出す場合は、SQLFetch() を呼び出してカーソルを進めます。
その後、次の行から値を取り出すことができます。 |
| SQLEndTran() または SQLExecute() |
必要な選択 |
この時点で、トランザクションを SQLEndTran() を用いて終了して、異なるパラメーター値を指定して SQLExecute() で同じ SQL ステートメントを再実行するか、SQLExecute() を使用して、同じトランザクション内で別の SQL ステートメントを実行できます。 |
| SQLFreeHandle() または SQLPrepare() |
必要な選択 |
トランザクションをコミットした後、ステートメントを SQLFreeHandle() を用いて解放すること
ができます。あるいは、新しい SQL ステートメントを準備し、実行して、新規トランザクション
を開始することができます。 |
データを更新する SQL ステートメントの場合、通常は、次の表で示す関数の順序を使用します。
表の中のそれぞれの行は、オプションの関数呼び出しまたは関数呼び出し間の選択を表しています。
これらの関数呼び出しは、アプリケーションに組み込む順序で示されています。
| 関数呼び出し |
使用法 |
説明 |
| SQLRowCount() |
オプション |
SQL ステートメントが変更した行数を戻します。 |
| SQLEndTran() または SQLExecute() |
必要な選択 |
この時点で、トランザクションを SQLEndTran() を用いて終了して、SQLExecute() を使用して異なるパラメーター値を指定して同じ SQL ステートメントを再実行するか、SQLExecute() を使用して、同じトランザクション内で、別の SQL ステートメントを実行することができます。 |
| SQLFreeHandle() または SQLPrepare() |
必要な選択 |
トランザクションをコミットした後、ステートメントを SQLFreeHandle() を用いて解放すること
ができます。あるいは、新しい SQL ステートメントを準備し、実行して、新規トランザクション
を開始することができます。 |
SQL データ定義ステートメントの場合、通常は、次の表で示す関数の順序を使用します。
表の中のそれぞれの行は、関数呼び出し間の選択を表しています。
これらの関数呼び出しは、アプリケーションに組み込む順序で示されています。
| 関数呼び出し |
使用法 |
説明 |
| SQLEndTran() または SQLExecute() |
必要な選択 |
この時点で、トランザクションを SQLEndTran() を用いて終了するか、同じ SQL ステートメントを
異なるパラメーター値を用いて再実行するか、
あるいは同じトランザクション内で別の SQL ステートメントを実行します。 |
| SQLFreeHandle() または SQLPrepare() |
必要な選択 |
トランザクションをコミットした後、ステートメントを SQLFreeHandle() を用いて解放すること
ができます。あるいは、新しい SQL ステートメントを準備し、実行して、新規トランザクション
を開始することができます。 |
詳細な説明の終了