場合によっては、アプリケーションで位置付けした UPDATE または DELETE を実行する場合に、カーソルを使用する必要があることもあります。それ以外では、診断メッセージに対してのみ確認する必要があります。
このタスクについて
ステートメントがデータを変更する場合 (UPDATE、DELETE、INSERT、または
MERGE) は、診断メッセージの
通常のチェックのほかは、その他のアクションは何も必要ありません。この場合、SQLRowCount() を
使用すると、その SQL ステートメントが影響を及ぼした行数が分かります。
SQL ステートメントが、位置付け UPDATE または位置付け DELETE の
場合、カーソル を使用する必要があります。
カーソルとは、アクティブな照会ステートメントの結果表の行を指す、
移動可能なポインターのことです。(この照会ステートメントには FOR UPDATE OF 文節を
入れて、照会が読み取り専用としてオープンされないようにする必要があります。)
組み込み SQL では、カーソル名は行の取り出し、更新、または削除に使用されます。Db2® ODBC では
、カーソルを名前で参照するため、位置付け UPDATE または位置付け DELETE の SQL ステートメント
でのみ、カーソル名が必要です。
手順
位置付け UPDATE または DELETE をアプリケーションで行うには、以下のようにします。
- SELECT ステートメントを出して、結果セットを生成します。
- SQLGetCursorName() を呼び出して、前のステップで生成した結果セットのカーソル名を取り出します。 このカーソル名を UPDATE または DELETE ステートメントで使用します。
ヒント: Db2 が自動的に生成する名前を使用してください。
SQLSetCursorName() を使用しても独自のカーソル名を定義することはできますが、Db2 が生成する名前を使用してください。すべてのエラー・メッセージは、SQLSetCursorName() を
用いて定義した名前ではなく、Db2 が生成した名前を参照します。
- 2 番目のステートメント・ハンドルを割り振って、位置付け UPDATE または DELETE を実行します。
フェッチされた行を更新または削除するには、2 つのステートメント・ハンドルを
使用します。1 つのハンドルはフェッチ用で、もう 1 つのハンドルは削除の更新用です。
フェッチのステートメント・ハンドルを再利用して、位置付け UPDATE または DELETE を実行する
ことはできません。その理由は、位置付け UPDATE または DELETE を実行中はこのハンドルが
カーソルを保持しているからです。
- SQLFetch() を呼び出して、カーソルを結果セットの行に置きます。
- WHERE CURRENT 文節を用いた UPDATE または DELETE SQL ステートメントを作成して、
ステップ 2 で取得したカーソル名を指定します。
sprintf((char *)stmtPositionedUpdate,
"UPDATE org SET location = 'San Jose' WHERE CURRENT of %s",
cursorName);
- 位置付け UPDATE または DELETE ステートメントを実行します。