Db2 ODBC での両方向スクロール・カーソル特性

Db2® ODBC では、 両方向スクロール・カーソルに、静的または動的のどちらにするかを定義できます。また、両方向スクロール・カーソルには、 感度および並行性を定義することもできます。

静的または動的カーソル

両方向スクロール・カーソルじゃ静的または動的にできます。静的および動的なカーソルは、更新の検出、結果セットから削除および結果セットへ挿入する機能において異なります。静的および動的カーソルの定義は、以下のとおりです。
静的
読み取り専用カーソル。カーソルがオープンした後に、そのアプリケーション、または別のアプリケーションによって行われる、挿入、削除、または更新を検出しません。
動的
カーソルのオープン後起こるすべての挿入、削除、および結果セットへの更新にセンシティブなカーソル。動的カーソルは結果セットへの挿入、結果セットからの削除、または結果セットの更新が可能です。

Db2 ODBC カーソルの特性の設定方法

照会を実行する前に、アプリケーションは、ステートメント属性 SQL_ATTR_CURSOR_TYPE を持つ SQLSetStmtAttr() を呼び出すことでカーソル・タイプを指定できます。デフォルト・カーソル・タイプは、前方スクロールです。

アプリケーションは、カーソル・タイプを指定するというよりカーソルの特性を指定することができます。アプリケーションは、SQLSetStmtAttr() で以下のステートメント属性を設定することで、これを行います。
  • SQL_ATTR_CURSOR_SCROLLABLE
  • SQL_ATTR_CURSOR_SENSITIVITY

ODBC ドライバーは、アプリケーションが要求する特性を最も効果的に提供するカーソル・タイプを選択します。

アプリケーションによって、以下のステートメント属性のいずれかを設定した場合、ODBC ドライバーはこのセット内のほかのステートメント属性を変更して動作が一貫性のあるように保ちます。
  • SQL_ATTR_CONCURRENCY
  • SQL_ATTR_CURSOR_SCROLLABLE
  • SQL_TTRCURSOR_SENSITIVITY
  • SQL_ATTR_CURSOR_TYPE

次の表には、Db2 ODBC での各カーソル・タイプのデフォルトの属性がリストされています。

表 1. 各カーソル・タイプのカーソル属性
カーソル・タイプ カーソル・センシティビティー カーソル並行性 カーソル・スクロール可能性
前方スクロール 指定されていません 読み取り専用並行性 スクロール不可能
静的 インセンシティブ 読み取り専用並行性 スクロール可能
動的 センシティブ ロック並行性 スクロール可能

どの特性がサポートされるかを判別する方法

すべてのデータベース・サーバーが、両方向スクロール・カーソルのすべてのタイプをサポートするわけではありません。そのため、両方向スクロール・カーソルを使用する前に、両方向スクロール・カーソルがサポートされているかどうかを判別する必要があります。

ODBC ドライバーおよびデータ・ソースによってサポートされる両方向スクロール・カーソルのタイプの判別、および各両方向スクロール・カーソル・タイプをサポートする機能を判別するには、SQLGetInfo() を呼び出します。 以下の InfoType 値を指定します。
  • SQL_CURSOR_SENSITIVITY
  • SQL_SCROLL_OPTIONS
  • SQL_FORWARD_ONLY_CURSOR_ATTRIBUTES1
  • SQL_FORWARD_ONLY_CURSOR_ATTRIBUTES2
  • SQL_KEYSET_CURSOR_ATTRIBUTES1
  • SQL_KEYSET_CURSOR_ATTRIBUTES2
  • SQL_DYNAMIC_CURSOR_ATTRIBUTES1
  • SQL_DYNAMIC_CURSOR_ATTRIBUTES2