SQLBulkOperations() - 行のセットの追加、更新、削除、またはフェッチ

SQLBulkOperations() で、新しい行を現行照会の動的カーソルで関連付けた基本表やビューに追加できます。

SQLBulkOperations() の ODBC 仕様

表 1. SQLBulkOperations() の仕様
ODBC 仕様レベル X/Open CLI CAE 仕様 ISO CLI 仕様
3.0 あり あり

構文

SQLRETURN SQLBulkOperations (
             SQLHSTMT      StatementHandle,
             SQLSMALLINT   Operation);

関数の引数

次の表は、この関数のそれぞれの引数ごとに、 データ・タイプ、用途、および説明を示しています。

表 2. SQLBulkOperations の引数
データ・タイプ 引数 使用法 説明
SQLHSTMT StatementHandle 入力 ステートメント・ハンドル。
SQLSMALLINT Operation 入力 実行する操作: SQL_ADD。
Db2® ODBC は次の操作をサポートしていません。
  • SQL_UPDATE_BY_BOOKMARK
  • SQL_DELETE_BY_BOOKMARK
  • SQL_FETCH_BY_BOOKMARK

使用法

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() で実行される場合、列を無視できます。 列を無視するには、SQLBindCol() を呼び出し、列の長さとインディケーター・バッファー (pcbValue) を SQL_COLUMN_IGNORE に設定します。

SQLBulkOperations() 呼び出しの後:
  • SQL_ATTR_ROWS_FETCHED_PTR ステートメント属性が指すバッファーに、呼び出しで影響のある行数が含まれます。
  • SQL_ATTR_ROW_STATUS_PTR ステートメント属性が指す行状況配列に、操作の結果が含まれます。
  • ブロック・カーソル位置は未定義です。アプリケーションは SQLFetchScroll() を呼び出し、カーソル位置を設定します。アプリケーションは、FetchOrientation 引数を SQL_FETCH_FIRST、SQL_FETCH_LAST または SQL_FETCH_ABSOLUTE に設定して、SQLFetchScroll() を呼び出す必要があります。カーソル位置は、アプリケーションが、SQLFetch() または SQLFetchScroll() (FetchOrientation 引数を SQL_FETCH_PRIOR、SQL_FETCH_NEXT または SQL_FETCH_RELATIVE に設定) を呼び出す場合は、未定義です。
アプリケーションは以下を行う必要はありません。
  • SQLBulkOperations() を呼び出す前に SQLFetch() または SQLFetchScroll() を呼び出します。
  • SQL_ATTR_ROW_OPERATION_PTR ステートメント属性を SQLBulkOperations() 呼び出しに対して設定します。 一括操作が SQLBulkOperations() で実行される場合、行を無視できます。

Operation 引数が SQL_ADD で、カーソルと関連付けされている照会の選択リストの中に同じ列への複数の参照がある場合、エラーが発生します。

行状況配列: 行状況配列には、SQLBulkOperations() の呼び出し後、行セット内の各行のデータの状況値が含まれます。 この配列は、SQLFetch() または SQLFetchScroll() が呼び出されないうちに SQLBulkOperations() が呼び出される場合、SQLBulkOperations() の呼び出しによって最初にデータを設定します。 SQL_ATTR_ROW_STATUS_PTR ステートメント属性は行状況配列を指します。 行状況配列内のエレメント数は、SQL_ATTR_ROW_ARRAY_SIZE ステートメント属性で定義されたように、行セット内の行数と同じにする必要があります。

戻りコード

  • SQL_SUCCESS
  • SQL_SUCCESS_WITH_INFO
  • SQL_NEED_DATA
  • SQL_STILL_EXECUTING
  • SQL_ERROR
  • SQL_INVALID_HANDLE

診断

表 3. SQLBulkOperations の SQLSTATE
SQLSTATE 説明 説明
01000 警告。 通知メッセージ。(関数は SQL_SUCCESS_WITH_INFO を戻します。)
07006 変換が無効です。 Operation 引数が SQL_ADD で、アプリケーション・バッファー内のデータ値が結果セット内の列のデータ・タイプに変換できませんでした。
22001 ストリング・データの右側が切り捨てられました。 列へ文字値またはバイナリー値を割り当てることによって、非ブランク (文字の場合) または非ヌル (バイナリーの場合) の文字かバイトの切り捨てが起こりました。
22003 数値が範囲外です。 Operation 引数は SQL_ADD でした。結果セット内の列へ数値を割り当てることによって数値全体 (一部とは対照的に) が切り捨てられました。
22008 日時形式が無効または日時フィールドがオーバーフローしました。 以下の状態のいずれかが発生しました。
  • Operation 引数は SQL_ADD でした。結果セット内の列に日付値またはタイム・スタンプ値を割り当てによって、年、月、日のフィールドが範囲外になりました。
  • Operation 引数は SQL_ADD でした。結果セット内の列に送られたデータの日時算術演算の結果、日時フィールド (年、月、日、時、分、または秒フィールド) がフィールドに許容される値の範囲外になったか、グレゴリオ暦の日時値として自然の規則に基づくと無効になりました。
22018 割り当てにエラーがありました。 引数 Operation は SQL_ADD でした。列に割り当てられたデータ値は、結果セットの関連付けられた列のデータ・タイプと互換性がありませんでした。
23000 保全性制約違反。 整合性の制約に違反していました。以下の状態のいずれかが発生しました。
  • Operation 引数は SQL_ADD でした。バインドされていなかった列が、NOT NULL で定義されていて、デフォルトがありません。
  • Operation 引数は SQL_ADD でした。バインドされた pcbValue で指定された長さが、SQL_COLUMN_IGNORE で列にデフォルト値がありませんでした。
24000 カーソル状態が無効です。 StatementHandle が実行された状態にあったが、結果セットが StatementHandle と関連付けられていませんでした。
40001 トランザクション・ロールバック。 フェッチが実行されたトランザクションは、デッドロックを避けるために終了されました。
40003 ステートメント完了が不明です。 関連付けられた接続が、この関数の実行中に失敗しました。 トランザクションの状態を判別できません。
42xxx1 構文エラーまたはアクセス規則違反。 これらの SQLSTATE は、以下のエラーのいずれかを示しています。
  • 425xx の場合、許可 ID には、Operation 引数で要求された操作を実行するための権限がありません。
  • 42xxx の場合は、ステートメントに関してさまざまな構文上の問題 またはアクセス上の問題があることを示しています。
44000 WITH CHECK OPTION 違反。 Operation 引数は SQL_ADD でした。挿入または更新が、表示された表か表示された表から派生させられた表で実行されました。表示された表は、WITH CHECK OPTION を指定することで作成されました。 挿入によって影響を受ける 1 つ以上の行が表示された表にもうありません。
HY000 一般エラー。 特定の SQLSTATE が存在しないエラーが起こりました。SQLGetDiagRec() が *MessageText バッファー に戻したエラー・メッセージに、エラーとその原因が記述されています。
HY001 メモリー割り振りエラー。 Db2 ODBC は、関数の実行または完了をサポートするのに必要なメモリーを割り振れませんでした。アプリケーション・プロセスのためにプロセス・レベルのメモリーを使い尽くした可能性があります。 オペレーティング・システムの構成を調べて、プロセス・レベルのメモリー制限に関する情報を確認してください。
HY010 関数シーケンス・エラーが発生しました。 関数が、実行時データ (SQLParamData() または SQLPutData()) の操作中に呼び出されました。
HY011 この時点では操作は無効です。 SQL_ATTR_ROW_STATUS_PTR ステートメント属性が、SQLFetch() または SQLFetchScroll() と SQLBulkOperations の呼び出しの間に設定されました。
HY013 予期しないメモリー処理エラーです。 Db2 ODBC は、この関数の実行または完了をサポートするのに必要なメモリーにアクセスできませんでした。
HY090 ストリングまたはバッファーの長さが無効です。 以下の状態のいずれかが発生しました。
  • Operation 引数は SQL_ADD でした。データ値は、NULL ポインタ ーでした。列の長さの値が 0 ではなく、SQL_DATA_AT_EXEC、 SQL_COLUMN_IGNORE、 SQL_NULL_DATA、 ではなく、または SQL_LEN_DATA_AT_EXEC_OFFSET 以下でした。
  • Operation 引数は SQL_ADD でした。データ値は NULL ポインターではありませんでした。C データ・タイプは SQL_C_BINARY または SQL_C_CHAR でした。列の長さの値は、0 より小さいが、 SQL_DATA_AT_EXEC、 SQL_COLUMN_IGNORE、 SQL_NTS、または SQL_NULL_DATA に等 しくないか、 SQL_LEN_DATA_AT_EXEC_OFFSET 以下でした。
HY092 無効な属性 ID。 Operation 引数は SQL_ADD でした。SQL_ATTR_CONCURRENCY ステートメント属性は、SQL_CONCUR_READ_ONLY に設定されていました。
HYC00 ドライバーは使用できません。 Db2 ODBC またはデータ・ソースは、Operation 引数で要求された操作をサポートしません。
注:
  1. xxx は、そのクラス・コードの任意の SQLSTATE を表します。例えば、37xxx は、クラス・コード '37' の 任意の SQLSTATE を表しています。