Db2 ODBC アプリケーションで、両方向スクロール・カーソルを使用してデータを取り出す手順

Db2® ODBC アプリケーションで両方向スクロール・カーソルを使用する場合、 行セット・サイズの設定、両方向スクロール・カーソルのタイプの指定、取得データを入れる領域のセットアップ、アプリケーション・データのバインド、 結果セット・サイズの決定、データのフェッチ、カーソルの複数回の移動、およびカーソルのクローズが必要です。

手順

両方向スクロール・カーソルを使用してデータを取り出すには、以下のようにします。

  1. SQLSetStmtAttr() を呼び出し、結果セットから戻される行セットのサイズを指定します。 SQL_ATTR_ROW_ARRAY_SIZE ステートメント属性を各フェッチ操作に対して戻される行数に設定します。デフォルトの行セット・サイズは 1 です。
    例えば、この呼び出しでは、行セット・サイズを 35 行に宣言します。
    #define ROWSET_SIZE 35 
    /* ... */ 
    rc = SQLSetStmtAttr(hstmt, 
                        SQL_ATTR_ROW_ARRAY_SIZE, 
                        (SQLPOINTER) ROWSET_SIZE, 
                        0); 
  2. SQLSetStmtAttr() を呼び出し、使用する静的両方向スクロール・カーソルを静的または動的のどちらにするかを指定します。SQL_ATTR_CURSOR_TYPE ステートメント属性を静的読み取り専用カーソルにするには SQL_CURSOR_STATIC を、動的カーソルにするには SQL_CURSOR_DYNAMIC を指定します。 デフォルト・カーソル・タイプは SQL_CURSOR_FORWARD_ONLY です。
    例えば、この呼び出しは、静的カーソルを指定します。
    rc = SQLSetStmtAttr(hstmt, 
                        SQL_ATTR_CURSOR_TYPE, 
                        (SQLPOINTER) SQL_CURSOR_STATIC, 
                        0); 
  3. ストレージ域にタイプ SQLUINTEGER を宣言し、SQLFetchScroll() の各呼び出しで行セットに戻される行数を含むようにします。 SQLSetStmtAttr() を呼び出し、ストレージ域のロケーションを指定します。 SQL_ATTR_ROWS_FETCHED_PTR ステートメント属性をストレージ域へのポインターとして設定します。
    例えば、このコードは rowsFetchedNb 変数を戻される行数のストレージ域として設定します。
    /* ... */ 
    SQLUINTEGER rowsFetchedNb; 
    /* ... */ 
    rc = SQLSetStmtAttr(hstmt, 
                        SQL_ATTR_ROWS_FETCHED_PTR, 
                        &rowsFetchedNb, 
                        0); 
  4. SQLUSMALLINT 値の配列であるストレージ域を宣言して、行状況配列を含むようにします。SQLSetStmtAttr() を呼び出し、行状況配列のロケーションを指定します。 SQL_ATTR_ROW_STATUS_PTR ステートメント属性を行状況配列へのポインターとして設定します。

    行状況配列のサイズは、SQL_ATTR_ROW_ARRAY_SIZE ステートメント属性で定義された行セット・サイズに等しくしてください。

    例えば、このコードは、配列 row_status を行状況配列として設定します。
    /* ... */ 
    SQLUSMALLINT row_status[ROWSET_SIZE]; 
    /* ... */ 
    /* Set a pointer to the array to use for the row status */ 
    rc = SQLSetStmtAttr(hstmt, 
                        SQL_ATTR_ROW_STATUS_PTR, 
                        (SQLPOINTER) 
                        row_status, 
                        0); 
  5. 結果セットを定義する SQL SELECT ステートメントを実行します。列方向または行方向バインディングを使用して、結果をバインドします。 このステップでは、順方向カーソルに対してと同じです。
  6. SQLRowCount() を呼び出し、結果セット内の行数を決定します。
  7. 結果セットから行の行セットをフェッチします。実行するには、以下のようにします。
    1. SQLFetchScroll() を呼び出し、結果セットからデータの行セットをフェッチします。 FetchOrientation および FetchOffset 引数を設定し、結果セット内の行セットのロケーションを示します。
    2. 結果セットに戻された行数を判別します。 Db2 ODBC は SQLFetchScroll() の各呼び出しの後に、ステートメント属性 SQL_ATTR_ROWS_FETCHED_PTR が指す場所と行状況配列に、この値を設定します。
      例えば、この呼び出しはカーソルを結果セットの 11 番目の行に設定し行セットをフェッチします。
      rc = SQLFetchScroll(hstmt,              /* Statement handle */ 
                          SQL_FETCH_ABSOLUTE, /* FetchOrientation value */ 
                          11);                /* Offset value */ 
    3. 取り出された行の表示または取り扱い
    4. より多くの行セットをスクロールしてフェッチするには、この手順に記載される前のサブステップを繰り返します。
  8. すべての行セットを取り出した後は、SQLCloseCursor() を呼び出してカーソルをクローズするか、HandleType 値に SQL_HANDLE_STMT を指定して SQLFreeHandle() を呼び出してステートメント・ハンドルを解放します。ステートメント・ハンドルを解放すると、 結果セットはクローズされます。