バルク挿入および置かれた更新の長いデータの用意

バルク挿入または置かれた更新のために長いデータを用意するには、SQLBulkOperations() または SQLSetPos() 呼び出しを使用します。

手順

長いデータを持つ一括挿入または置かれた更新の実行を行うには、以下のようにします。

  1. SQLBindCol() を使用してデータをバインドします。SQLBindCol() を呼び出す場合:
    1. 列番号などの、アプリケーションで定義された値を、実行時データ列の *rgbValue バッファーに入れます。*rgbValue バッファーの値は、後で列を識別するのに使用できます。
    2. SQL_DATA_AT_EXEC 値を *pcbValue バッファーに入れます。
  2. SQLBulkOperations() または SQLSetPos() を呼び出します。 実行時データ列がある場合は、SQLBulkOperations() は、SQL_NEED_DATA を戻して、ステップ 3 に進みます。 実行時データ列がない場合は、処理は完了します。
  3. SQLParamData() を呼び出し、処理される最初の実行時データ列の *rgbValue バッファーのアドレスを取り出します。 SQLParamData() は、SQL_NEED_DATA を戻します。
    1. アプリケーションで定義された値を、*rgbValue バッファーから取り出します。 実行時データ・パラメーターが実行時データ列に似ていても、SQLParamData() によって戻される値は、実行時データ・パラメーターと実行時データ列では異なります。 実行時データ列とは、SQLBulkOperations() または SQLSetPos() を持つ行の挿入または更新の後に、SQLPutData() を持つデータを送信する行セットにある列です。 実行時データ列を SQLBindCol() でバインドします。SQLParamData() に戻される値は、処理される *rgbValue バッファーにある行のアドレスです。
  4. SQLPutData() を 1 回以上呼び出して列にデータを送ります。 データ値が SQLPutData() に指定された *rgbValue バッファーに戻されない場合は、複数の呼び出しが必要です。同じ列の SQLPutData() の複数の呼び出しは、以下の事情でのみ許可されます。
    • 文字 C データを、文字、バイナリー、またはデータ・ソース固有のデータ・タイプを持つ列に送る場合
    • バイナリー C データを、文字、バイナリー、またはデータ・ソース固有のデータ・タイプを持つ列に送る場合
  5. SQLParamData() を再び呼び出し、すべてのデータが列に送られたことを知らせます。
    • 実行時データ列が大量にある場合は、SQLParamData() は、SQL_NEED_DATA と処理される次の実行時データ列の *rgbValue バッファーのアドレスを戻します。ステップ 4 と 5 を繰り返します。
    • 実行時データ列がこれ以上ない場合、処理は完了します。

      ステートメントが正常に実行されて、SQLParamData() が SQL_SUCCESS または SQL_SUCCESS_WITH_INFO を戻します。実行が失敗した場合は、SQL_ERROR を戻します。 この時点で、SQLParamData() は、SQLBulkOperations() によって戻される可能性がある SQLSTATE を戻すことがあります。

    • SQLBulkOperations() または SQLSetPos() が、 SQL_NEED_DATA を戻した後、およびすべての実行時データ列のデータを取り出す前に、操作が取り消された場合、あるいは SQLParamData() や SQLPutData() でエラーが発生した場合、ステートメントまたはステートメントに関連付けられた接続に対して SQLCancel()、SQLGetDiagRec()、SQLGetFunctions()、SQLParamData()、SQLPutData() しか呼び出せません。 ステートメントまたはステートメントに関連付けられている接続の別の関数を呼び出すと、関数は SQL_ERROR および SQLSTATE HY010 (関数シーケンス・エラー) を戻します。
    • ODBC が実行時データ列のデータを必要としている間に SQLCancel() を呼び出すと、ODBC は操作を取り消します。すると SQLBulkOperations() または SQLSetPos() を再び呼び出せます。取り消しても、カーソルの状態または現行カーソル位置に影響はありません。