SQLBulkOperations() を使用した一括挿入の実行

SQLBulkOperations() を呼び出すことでデータ・ソースにある表またはビューに新しい行を挿入できます。

始める前に

SQLBulkOperations() を呼び出す前に、アプリケーションで必要な一括操作がサポートされていることを確認する必要があります。サポートを検査するには、InfoType を SQL_DYNAMIC_CURSOR_ATTRIBUTES1 または SQL_DYNAMIC_CURSOR_ATTRIBUTES2 に設定して、SQLGetInfo() を呼び出します。以下の属性を検査して、サポートが使用できることを確認します。
  • SQL_CA1_BULK_ADD
  • SQL_CA1_BULK_UPDATE_BY_BOOKMARK
  • SQL_CA1_BULK_DELETE_BY_BOOKMARK
  • SQL_CA1_BULK_FETCH_BY_BOOKMARK

このタスクについて

SQLBulkOperations() は、動的カーソルによって現行の結果セット上で作動し、結果セットに行われた変更の検出を可能にします。SQLBulkOperations() は、バインドされた各列のアプリケーション・バッファーにあるデータを使用して行を挿入します。

手順

バルク挿入を実行するには、以下のようにします。

  1. 結果セットを戻す照会を実行します。
  2. SQL_ATTR_ROW_ARRAY_SIZE ステートメント属性を、挿入する行数に設定します。
  3. SQLBindCol() を呼び出して、挿入するデータをバインドします。 データを、SQL_ATTR_ROW_ARRAY_SIZE の値に等しいサイズで配列にバインドします。
    以下の条件のいずれかが、真である必要があります。
    • SQL_ATTR_ROW_STATUS_PTR ステートメント属性に対する行状況配列のサイズが、SQL_ATTR_ROW_ARRAY_SIZE と同じ。
    • SQL_ATTR_ROW_STATUS_PTR が NULL ポインター。

    SQL_COLUMN_IGNORE のデータ長を持つすべてのバインドされた列およびアンバインドされたすべての列は NULL 値を受け入れ、デフォルトを持っている。

  4. SQLBulkOperations(StatementHandle、SQL_ADD) を呼び出して、挿入を実行します。 SQLBulkOperations() は、SQL_ATTR_ROW_OPERATION_PTR が指す行操作配列を無視します。
  5. アプリケーションで SQL_ATTR_ROW_STATUS_PTR ステートメント属性を設定した場合、行状況配列を検査して操作の結果をご覧ください。

例

以下の例は、照会を実行し、SQLBulkOperations() を使用して、10 行のデータを表 CUSTOMER に挿入するアプリケーションです。
a#define ROWSET_SIZE 10
/* declare and initialize local variables        */
SQLCHAR sqlstmt[] =
  "SELECT Cust_Num, First_Name, Last_Name FROM CUSTOMER";
SQLINTEGER Cust_Num[ROWSET_SIZE];
SQLCHAR First_Name[ROWSET_SIZE][21];
SQLCHAR Last_Name[ROWSET_SIZE][21];
SQLINTEGER Cust_Num_L[ROWSET_SIZE];
SQLINTEGER First_Name_L[ROWSET_SIZE];
SQLINTEGER Last_Name_L[ROWSET_SIZE];
SQLUSMALLINT rowStatus[ROWSET_SIZE];
/* Set up dynamic cursor type */
rc = SQLSetStmtAttr(hstmt,
  SQL_ATTR_CURSOR_TYPE,
  (SQLPOINTER) SQL_CURSOR_DYNAMIC,
  0);
/* Set pointer to row status array               */
rc = SQLSetStmtAttr(hstmt,
  SQL_ATTR_ROW_STATUS_PTR,
  (SQLPOINTER) rowStatus,
  0);
/* Execute query */
rc = SQLExecDirect(hstmt,sqlstmt,SQL_NTS);
/* Call SQLBindCol() for each result set column  */
rc = SQLBindCol(hstmt,
  1,
  SQL_C_LONG,
  (SQLPOINTER) Cust_Num,
  (SQLINTEGER) sizeof(Cust_Num)/ROWSET_SIZE,
  Cust_Num_L);
rc = SQLBindCol(hstmt,
  2,
  SQL_C_CHAR,
  (SQLPOINTER) First_Name,
  (SQLINTEGER) sizeof(First_Name)/ROWSET_SIZE,
  First_Name_L);
rc = SQLBindCol(hstmt,
  3,
  SQL_C_CHAR,
  (SQLPOINTER) Last_Name,
  (SQLINTEGER) sizeof(Last_Name)/ROWSET_SIZE,
  Last_Name_L);
…
/* For each column, place the new data values in */
/* the rgbValue array, and set each length value */
/* in the pcbValue array to be the length of the */
/* corresponding value in the rgbValue array.    */
…
/* Set number of rows to insert                  */
rc = SQLSetStmtAttr(hstmt,
  SQL_ATTR_ROW_ARRAY_SIZE,
  (SQLPOINTER) ROWSET_SIZE,
  0);
/* Perform the bulk insert                       */
rc = SQLBulkOperations(hstmt, SQL_ADD);