SQLBulkOperations() - 行のセットの追加、更新、削除、またはフェッチ
SQLBulkOperations() で、新しい行を現行照会の動的カーソルで関連付けた基本表やビューに追加できます。
SQLBulkOperations() の ODBC 仕様
| ODBC 仕様レベル | X/Open CLI CAE 仕様 | ISO CLI 仕様 |
|---|---|---|
| 3.0 | あり | あり |
構文
SQLRETURN SQLBulkOperations (
SQLHSTMT StatementHandle,
SQLSMALLINT Operation);
関数の引数
次の表は、この関数のそれぞれの引数ごとに、 データ・タイプ、用途、および説明を示しています。
| データ・タイプ | 引数 | 使用法 | 説明 |
|---|---|---|---|
| SQLHSTMT | StatementHandle | 入力 | ステートメント・ハンドル。 |
| SQLSMALLINT | Operation | 入力 | 実行する操作: SQL_ADD。 Db2® ODBC は次の操作をサポートしていません。
|
使用法
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
診断
| SQLSTATE | 説明 | 説明 |
|---|---|---|
| 01000 | 警告。 | 通知メッセージ。(関数は SQL_SUCCESS_WITH_INFO を戻します。) |
| 07006 | 変換が無効です。 | Operation 引数が SQL_ADD で、アプリケーション・バッファー内のデータ値が結果セット内の列のデータ・タイプに変換できませんでした。 |
| 22001 | ストリング・データの右側が切り捨てられました。 | 列へ文字値またはバイナリー値を割り当てることによって、非ブランク (文字の場合) または非ヌル (バイナリーの場合) の文字かバイトの切り捨てが起こりました。 |
| 22003 | 数値が範囲外です。 | Operation 引数は SQL_ADD でした。結果セット内の列へ数値を割り当てることによって数値全体 (一部とは対照的に) が切り捨てられました。 |
| 22008 | 日時形式が無効または日時フィールドがオーバーフローしました。 | 以下の状態のいずれかが発生しました。
|
| 22018 | 割り当てにエラーがありました。 | 引数 Operation は SQL_ADD でした。列に割り当てられたデータ値は、結果セットの関連付けられた列のデータ・タイプと互換性がありませんでした。 |
| 23000 | 保全性制約違反。 | 整合性の制約に違反していました。以下の状態のいずれかが発生しました。
|
| 24000 | カーソル状態が無効です。 | StatementHandle が実行された状態にあったが、結果セットが StatementHandle と関連付けられていませんでした。 |
| 40001 | トランザクション・ロールバック。 | フェッチが実行されたトランザクションは、デッドロックを避けるために終了されました。 |
| 40003 | ステートメント完了が不明です。 | 関連付けられた接続が、この関数の実行中に失敗しました。 トランザクションの状態を判別できません。 |
| 42xxx1 | 構文エラーまたはアクセス規則違反。 | これらの SQLSTATE は、以下のエラーのいずれかを示しています。
|
| 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 | ストリングまたはバッファーの長さが無効です。 | 以下の状態のいずれかが発生しました。
|
| HY092 | 無効な属性 ID。 | Operation 引数は SQL_ADD でした。SQL_ATTR_CONCURRENCY ステートメント属性は、SQL_CONCUR_READ_ONLY に設定されていました。 |
| HYC00 | ドライバーは使用できません。 | Db2 ODBC またはデータ・ソースは、Operation 引数で要求された操作をサポートしません。 |
注:
|
||