関数ごとに、それぞれの ODBC 3.0 準拠レベルや Db2® ODBC サポート・レベルがあり、特定の関数が非推奨です。
次の各表は、特定のタスクをサポートする関数のリストを提供します。
各表は、
Db2 ODBC サポートのレベル、および Microsoft ODBC 3.0 準拠レベルを、関数ごとに示しています。
表には、列ごとに次の値が含まれます。
- ODBC 3.0 のレベル
- この列の値には、以下の意味があります。
- なし
- この関数は ODBC 3.0 ではサポートされていないことを示しています。
- 非推奨
- この関数はサポートされていますが、ODBC 3.0 では「使用すべきでない」ことを示しています。
- コア
- この関数は、ODBC 3.0 コア準拠レベルの一部であることを示しています。
- レベル 1
- この関数は、ODBC 3.0 レベル 1 準拠の一部であることを示しています。
- レベル 2
- この関数は、ODBC 3.0 レベル 2 準拠の一部であることを示しています。
- Db2 ODBC
サポート
- この列の値には、以下の意味があります。
- なし
- この関数は Db2 ODBC ではサポートされていないことを示しています。
- 非推奨
- この関数はサポートされていますが、Db2 ODBC では「使用すべきでない」ことを示しています。
- 現行
- この関数は Db2 ODBC では現行であることを示しています。現行の関数は Db2 ODBC によって
サポートされており、別の Db2 ODBC 関数によって「使用すべきでない」ということはありません。
データ・ソースへの接続
表 1. データ・ソースへの接続のための関数| 関数名 |
ODBC 3.0 のレベル |
Db2 ODBC
サポート |
目的 |
| SQLAllocConnect() |
非推奨 |
非推奨 |
接続ハンドルを取得します。 |
| SQLAllocEnv() |
非推奨 |
非推奨 |
環境ハンドルを取得します。
1 つ以上の接続に対して 1 つの環境ハンドルが使用されます。 |
| SQLAllocHandle() |
コア |
現行 |
ハンドルを取得します。 |
| SQLBrowseConnect() |
レベル 1 |
なし |
接続属性および有効な属性値の連続レベルを戻します。 それぞれの接続属性ごとに値が指定されている場合、
この関数はデータ・ソースに接続します。 |
| SQLConnect() |
コア |
現行 |
データ・ソース名、ユーザー ID、およびパスワードによって特定のドライバーに接続します。 |
| SQLDriverConnect() |
コア |
現行 |
接続ストリングで特定のドライバーに接続します。
IBM® 固有: この関数は、Db2 for Linux, UNIX, and Windows CLI 環境にある ODBC.INI ファイル内で
サポートされている追加の IBM キーワードによっても拡張されます。
Db2 for z/OS® ODBC 環境内では、ODBC.INI ファイルに相当するものはありません。
|
| SQLSetConnection() |
なし |
現行 |
接続ストリングで特定のデータ・ソースに接続します。 |
ドライバーおよびデータ・ソースに関する情報の入手
表 2. ドライバーおよびデータ・ソースに関する情報の入手のための関数| 関数名 |
ODBC 3.0 のレベル |
Db2 ODBC の状況 |
目的 |
| SQLDataSources() |
コア |
現行 |
使用可能なデータ・ソースのリストを戻します。 |
| SQLDrivers() |
コア |
なし |
インストールされたドライバーおよびその属性のリストを戻します (ODBC 2.0)。
この関数は、ODBC ドライバー・マネージャー内でインプリメントされている
ため、Db2 for z/OS ODBC 環境内では適用できません。 |
| SQLGetFunctions() |
コア |
現行 |
サポートされるドライバー関数を戻します。 |
| SQLGetInfo() |
コア |
現行 |
特定のドライバーおよびデータ・ソースに関する情報を戻します。 |
| SQLGetTypeInfo() |
コア |
現行 |
サポートされているデータ・タイプに関する情報を戻します。 |
ドライバー属性の設定と取り出し
表 3. ドライバー属性の設定と取り出しのための関数| 関数名 |
ODBC 3.0 のレベル |
Db2 ODBC
サポート |
目的 |
| SQLGetConnectAttr() |
コア |
現行 |
接続属性の値を戻します。 |
| SQLGetConnectOption() |
非推奨 |
非推奨 |
接続属性の値を戻します。 |
| SQLGetEnvAttr() |
コア |
現行 |
環境属性の値を戻します。 |
| SQLGetStmtAttr() |
コア |
現行 |
ステートメント属性の値を戻します。 |
| SQLGetStmtOption() |
非推奨 |
非推奨 |
ステートメント属性の値を戻します。 |
| SQLSetConnectAttr() |
コア |
現行 |
接続属性を設定します。 |
| SQLSetConnectOption() |
非推奨 |
非推奨 |
接続属性を設定します。 |
| SQLSetEnvAttr() |
コア |
現行 |
環境属性を設定します。 |
| SQLSetStmtAttr() |
コア |
現行 |
ステートメント属性を設定します。 |
| SQLSetStmtOption() |
非推奨 |
非推奨 |
ステートメント属性を設定します。 |
記述子フィールドの設定と取り出し
表 4. 記述子フィールドの設定と取り出しのための関数| 関数名 |
ODBC 3.0 のレベル |
Db2 ODBC
サポート |
目的 |
| SQLCopyDesc() |
コア |
なし |
記述子フィールドをコピーします。 |
| SQLGetDescField() |
コア |
なし |
単一記述子フィールドの値または現行設定値を戻します。 |
| SQLGetDescRec() |
コア |
なし |
複数記述子フィールドの値または現行設定値を戻します。 |
| SQLSetDescField() |
コア |
なし |
単一記述子フィールドの値または設定値を設定します。 |
| SQLSetDescRec() |
コア |
なし |
複数記述子フィールドの値または設定値を設定します。 |
SQL 要求の準備
表 5. SQL 要求の準備のための関数| 関数名 |
ODBC 3.0 のレベル |
Db2 ODBC
サポート |
目的 |
| SQLAllocStmt() |
非推奨 |
非推奨 |
ステートメント・ハンドルを割り振ります。 |
| SQLBindFileToParam() |
なし |
現行 |
SQL ステートメント内のパラメーター・マーカーをファイル参照またはファイル参照の配列に関連付けます。 |
| SQLBindParameter() |
コア |
現行 |
SQL ステートメントのパラメーター用のストレージを割り当てます (ODBC 2.0)。 |
| SQLGetCursorName() |
コア |
現行 |
ステートメント・ハンドルに関連したカーソル名を戻します。 |
| SQLParamOptions() |
非推奨 |
現行 |
パラメーターに複数の値の使用を指定します。
ODBC 3.0 では、SQLSetStmtAttr() がこの関数を置き換えます。 |
| SQLPrepare() |
コア |
現行 |
後続の実行のために SQL ステートメントを準備します。 |
| SQLSetCursorName() |
コア |
現行 |
カーソル名を指定します。 |
| SQLSetParam() |
非推奨 |
非推奨 |
SQL ステートメントのパラメーター用のストレージを割り当てます (ODBC 2.0)。ODBC 3.0 では、SQLBindParameter() がこの関数を置き換えます。 |
| SQLSetScrollOptions() |
非推奨 |
なし |
カーソルの動作を制御する属性を設定します。
ODBC
3.0 では、SQLGetInfo() および SQLSetStmtAttr() が、この関数を置き換えます。 |
要求のサブミット
表 6. 要求のサブミットのための関数| 関数名 |
ODBC 3.0 のレベル |
Db2 ODBC
サポート |
目的 |
| SQLDescribeParam() 1 |
コア |
現行 |
ステートメント内の特定の入力パラメーターに関する説明を戻します。 |
| SQLExecDirect() |
コア |
現行 |
ステートメントを実行します。 |
| SQLExecute() |
コア |
現行 |
準備済みステートメントを実行します。 |
| SQLNativeSql() |
コア |
現行 |
ドライバーによって変換された SQL ステートメントのテキストを戻します。 |
| SQLNumParams() |
コア |
現行 |
ステートメント内のパラメーターの数を戻します。 |
| SQLParamData() |
コア |
現行 |
SQLPutData() と一緒に使用します。実行時にパラメーター・データを
提供します。(長いデータ値の場合に便利です。) |
| SQLPutData() |
コア |
現行 |
パラメーター用のデータ値の一部または全部を送信します。(この関数は、長いデータ値の場合に便利です。) |
結果および結果に関する情報の取り出し
表 7. 結果および結果に関する情報の取り出しのための関数| 関数名 |
ODBC 3.0 のレベル |
Db2 ODBC
サポート |
目的 |
| SQLBindCol() |
コア |
現行 |
結果列のためのストレージを割り当て、データ・タイプを指定します。 |
| SQLBindFileToCol() |
なし |
現行 |
結果セット内の LOB 列をファイル参照またはファイル参照の配列に関連付けます。 |
| SQLBulkOperations() |
レベル 1 |
現行 |
一括挿入操作を行います。 |
| SQLColAttribute() |
コア |
現行 |
結果セット内の列の属性を記述します。 |
| SQLColAttributes() |
非推奨 |
非推奨 |
結果セット内の列の属性を記述します。 |
| SQLDescribeCol() |
コア |
現行 |
結果セット内の列について記述します。 |
| SQLError() |
非推奨 |
非推奨 |
追加のエラー情報または状況情報を戻します。 |
| SQLExtendedFetch() |
非推奨 |
現行 |
複数の結果行を戻します。 |
| SQLFetch() |
コア |
現行 |
1 つの結果行を戻します。 |
| SQLFetchScroll() |
コア |
現行 |
絶対位置または相対位置によって指定された行セットを戻します。 |
| SQLGetData() |
コア |
現行 |
結果セットの 1 つの行の 1 つの列の一部または全部を戻します。 (この関数は、長いデータ値の場合に便利です。) |
| SQLGetDiagRec() |
コア |
現行 |
追加の診断情報を戻します。 |
| SQLGetSQLCA() |
なし |
現行 |
ステートメント・ハンドルに関連した SQLCA を戻します。 |
| SQLMoreResults() |
レベル 1 |
現行 |
結果セットがまだあるかどうかを判別し、ある場合には、
次の結果セットの処理を初期化します。 |
| SQLNumResultCols() |
コア |
現行 |
結果セット内の列の数を戻します。 |
| SQLRowCount() |
コア |
現行 |
挿入、更新、削除、またはマージの要求によって影響を受ける行数を戻します。 |
| SQLSetColAttributes() |
なし |
現行 |
結果セット内の列の属性を設定します。 |
| SQLSetPos() |
レベル 1 |
現行 |
アプリケーションで、行セット内の行のリフレッシュ、更新、削除、および挿入ができるようにします。 |
ラージ・オブジェクトの処理
表 8. ラージ・オブジェクトの処理のための関数| 関数名 |
ODBC 3.0 のレベル |
Db2 ODBC
サポート |
目的 |
| SQLGetLength() |
なし |
現行 |
LOB ロケーターが参照するストリングの長さをバイトで取得します。 |
| SQLGetPosition() |
なし |
現行 |
LOB ロケーターが参照するソース・ストリング内のストリングの位置を取得します。 |
| SQLGetSubString() |
なし |
現行 |
ソース・ストリング内のサブストリングを参照する新規
の LOB ロケーターを作成します (ソース・ストリングも LOB ロケーター
によって表します)。 |
カタログからの情報の取得
表 9. カタログ情報の取得のための関数| 関数名 |
ODBC 3.0 のレベル |
Db2 ODBC
サポート |
目的 |
| SQLColumnPrivileges() |
レベル 2 |
現行 |
1 つの表に関する列および関連特権のリストを戻します。 |
| SQLColumns() |
コア |
現行 |
指定された表の列名のリストを戻します。 |
| SQLForeignKeys() |
レベル 2 |
現行 |
指定された表に外部キーが存在する場合、外部キーを含む列名のリストを戻します。 |
| SQLPrimaryKeys() |
レベル 1 |
現行 |
表の主キーを含む列名のリストを戻します。 |
| SQLProcedureColumns() |
レベル 1 |
現行 |
指定されたプロシージャーの結果セットを構成する列、および
入出力パラメーターのリストを戻します。 |
| SQLProcedures() |
レベル 1 |
現行 |
特定のデータ・ソースに保管されたプロシージャー名のリストを戻します。 |
| SQLSpecialColumns() |
コア |
現行 |
指定された表の行を一意的に識別する最適な列セットに関する情報を戻します。
または、行のいずれかの値がトランザクションによって更新されると自動的に
更新される列を識別します。 |
| SQLStatistics() |
コア |
現行 |
単一の表に関する統計およびその表に関連付けられた索引のリストを戻します。 |
| SQLTablePrivileges() |
レベル 2 |
現行 |
表のリスト、およびそれぞれの表に関連付けられた特権のリストを戻します。 |
| SQLTables() |
コア |
現行 |
特定のデータ・ソースに保管された表名のリストを戻します。 |
ステートメントの終了
表 10. ステートメントの終了のための関数| 関数名 |
ODBC 3.0 のレベル |
Db2 ODBC
サポート |
目的 |
| SQLCancel() |
コア |
現行 |
SQL ステートメントを取り消します。 |
| SQLCloseCursor() |
コア |
現行 |
ステートメント・ハンドルでオープンされているカーソルをクローズします。 |
| SQLEndTran() |
コア |
現行 |
トランザクションをコミットまたはロールバックします。 |
| SQLFreeStmt() |
コア |
現行 |
ステートメントの処理を終了し、関連するカーソルをクローズし、
ペンディング結果を廃棄し、またオプションで、ステートメント・ハンドルに関連する
すべてのリソースを解放します。 |
| SQLTransact() |
非推奨 |
非推奨 |
トランザクションをコミットまたはロールバックします。 |
接続の終了
表 11. 接続の終了のための関数| 関数名 |
ODBC 3.0 のレベル |
Db2 ODBC
サポート |
目的 |
| SQLDisconnect() |
コア |
現行 |
接続をクローズします。 |
| SQLFreeConnect() |
非推奨 |
非推奨 |
接続ハンドルを解放します。 |
| SQLFreeEnv() |
非推奨 |
非推奨 |
環境ハンドルを解放します。 |
| SQLFreeHandle() |
コア |
現行 |
環境ハンドル、接続ハンドル、ステートメント・ハンドル、または記述子ハンドルを解放します。 |
Db2 ODBC でサポートされていない ODBC 3.0 関数
以下の ODBC 3.0 関数は、Db2 ODBC ではサポートされていません。
- SQLBrowseConnect()
- SQLCopyDesc()。Db2 ODBC は、記述子フィールドをサポートしていません。
- SQLDrivers()。この関数は、Db2 ODBC に適用されない ODBC ドライバー・マネージャーによって
インプリメントされています。
- SQLGetDescField()。Db2 ODBC は、記述子フィールドをサポートしていません。
- SQLGetDescRec()。Db2 ODBC は、記述子フィールドをサポートしていません。
- SQLSetDescField()。Db2 ODBC は、記述子フィールドをサポートしていません。
- SQLSetDescRec()。Db2 ODBC は、記述子フィールドをサポートしていません。
- SQLSetScrollOptions()。この関数は、以下のステートメント属性に置き換えられました。
- SQL_ATTR_CURSOR_TYPE
- SQL_ATTR_CONCURRENCY
- SQL_KEYSET_SIZE
- SQL_ATTR_ROWSET_SIZE