詳細な説明の開始
この図は、一部のパラメーター・マーカーに対して複数の値を指定し、別のパラメーター・マーカーに対して単一値を指定して、MERGE ステートメントの実行を呼び出す関数を表したフローチャートです。このフローチャートでは、複数の値を渡す 2 つの方法が示されています。 これらの方法のいずれかで別々の準備と実行ステップを使用して、1 つの方法により準備と実行のステップを結合します。ここでは、これらの方法は 2 つの別の表で示します。
以下の表では、別々の準備と実行のステップを指定した MERGE の実行処理を説明しています。表の中の各行は、このプロセスにおける関数呼び出しを表します。
これらの各関数は必須です。
これらの関数はアプリケーションで呼び出される順序で記載してあります。
| 関数呼び出し | 説明 |
|---|---|
| SQLAllocHandle() | ステートメント・ハンドルを割り振ります。 |
| SQLPrepare() | SQL 照会を準備します。 |
| SQLBindParameter() | SQL ステートメントのパラメーター・マーカーを配列にバインドします。 この関数は、SQL ステートメント内の各パラメーター・マーカーごとに 1 回呼び出します。 |
| SQLParamOptions() | それぞれの配列に含まれるエレメント数を指定します。 |
| SQLExecute() | SQL ステートメントを実行します。この関数を一回だけ呼び出して、すべての値を使用して SQL ステートメントを実行します。 |
| SQLFreeHandle() | ステートメント・ハンドルを解放します。 |
以下の表では、単一の準備と実行のステップを指定した MERGE の実行処理を説明しています。表の中の各行は、このプロセスにおける関数呼び出しを表します。
これらの各関数は必須です。
これらの関数はアプリケーションで呼び出される順序で記載してあります。
| 関数呼び出し | 説明 |
|---|---|
| SQLAllocHandle() | ステートメント・ハンドルを割り振ります。 |
| SQLBindParameter() | SQL ステートメントのパラメーター・マーカーを配列にバインドします。 この関数は、SQL ステートメント内の各パラメーター・マーカーごとに 1 回呼び出します。 |
| SQLSetStmtAttr() | SQL_ATTR_PARAMSET_SIZE 属性を使用して、 それぞれの配列の要素数を指定します。 |
| SQLExecDirect() | SQL ステートメントを準備し、実行します。この関数を一回だけ呼び出して、すべての値を使用して SQL ステートメントを実行します。 |
| SQLFreeHandle() | ステートメント・ハンドルを解放します。 |
詳細な説明の終了