SQLGetInfo() - 一般情報を取得する
SQLGetInfo() は、アプリケーションが現在接続されているデータベース管理システムに関する一般情報を戻します。 例えば、SQLGetInfo() は、 どのようなデータ変換がサポートされているかを示します。
SQLGetInfo() の ODBC 仕様
| ODBC 仕様レベル | X/Open CLI CAE 仕様 | ISO CLI 仕様 |
|---|---|---|
| 1.0 | あり | あり |
構文
SQLRETURN SQLGetInfo (SQLHDBC ConnectionHandle,
SQLUSMALLINT InfoType,
SQLPOINTER InfoValuePtr,
SQLSMALLINT BufferLength,
SQLSMALLINT *FAR StringLengthPtr);
関数の引数
次の表は、この関数のそれぞれの引数ごとに、 データ・タイプ、用途、および説明を示しています。
| データ・タイプ | 引数 | 使用法 | 説明 |
|---|---|---|---|
| SQLHDBC | ConnectionHandle | 入力 | 接続ハンドルを指定します。 |
| SQLUSMALLINT | InfoType | 入力 | 要求する情報のタイプを指定します。この引数は、表 3 の最初の欄にある値 のいずれかでなければなりません。 |
| SQLPOINTER | InfoValuePtr | 出力 (および入力) | この関数が取り出された情報を保管するバッファーを指します。
取り出す情報のタイプによって、次の 5 つのタイプの情報が戻されます。
|
| SQLSMALLINT | BufferLength | 入力 | 引数 InfoValuePtr が指すバッファーの最大長 (バイト) を指定します。 |
| SQLSMALLINT * | StringLengthPtr | 出力 | 出力情報が切り捨てられないようにするのに必要なバイト数を、この関数が戻すためのバッファーを指します。
ストリング出力の場合、このサイズには NUL 終止符は含まれません。 StringLengthPtr が指しているロケーションの値が 、BufferLength に指定されている InfoValuePtr バッファーのサイズよりも 大きい場合は、ストリング出力情報は BufferLength - 1 バイトに切り捨てられ、 この関数は SQL_SUCCESS_WITH_INFO を戻します。 |
使用法
表 3 は、引数 InfoType の可能な値 と SQLGetInfo() がその値について戻す情報の説明を示しています。この表では、ODBC 3.0 で 名前変更になった引数 InfoType を示しています。
- 'Y' または 'N' を含む文字ストリングの場合は、'N' が戻されます。
- 'Y' または 'N' 以外の値のみを含む文字ストリングの場合は、空ストリングが戻されます。
- 16 ビット整数の場合は、0 (ゼロ) が戻されます。
- 32 ビット整数の場合は、0 (ゼロ) が戻されます。
- 32 ビット・マスクの場合は、0 (ゼロ) が戻されます。
| InfoType | フォーマット | 説明および注 |
|---|---|---|
| SQL_ACCESSIBLE_PROCEDURES | ストリング (string) | 文字ストリング「Y」は、ユーザーが、関数 SQLProcedures() によって戻されるすべてのプロシージャーを実行できることを示します。「N」は、ユーザーが実行できないプロシージャーが戻されることを示します。 |
| SQL_ACCESSIBLE_TABLES | ストリング (string) | 文字ストリング「Y」は、ユーザーに、関数 SQLTables() によって戻されるすべての表に対して SELECT 特権を保証されることを示します。「N」は、ユーザーがアクセスできない表が戻されることを示します。 |
| SQL_ACTIVE_ENVIRONMENTS | 16 ビット整数 | Db2® ODBC ドライバーがサポートできるアクティブな環境の最大数。限界が指定解除されているかまたは不明な場合、この値はゼロに設定されます。 |
| SQL_AGGREGATE_FUNCTIONS | 32 ビット・マスク | 以下の総計機能の列挙をサポートするビット・マスク。
|
| SQL_ALTER_DOMAIN | 32 ビット・マスク | Db2 ODBC は、ALTER DOMAIN ステートメントがサポートされていないことを示す 0 を戻します。ODBC は以下の値も定義していますが
、Db2 ODBC はこれらの値は戻しません。
|
| SQL_ALTER_TABLE | 32 ビット・マスク | ALTER TABLE 中のどの文節がデータベース管理システムにサポートされているかを示します。
|
| SQL_ASCII_GCCSID | 32 ビット整数 | Db2 DSNHDECP の AGCCSID フィールドに現在設定されている ASCII GCCSID 値を指定します。 |
| SQL_ASCII_MCCSID | 32 ビット整数 | Db2 DSNHDECP の AMCCSID フィールドに現在設定されている ASCII MCCSID 値を指定します。 |
| SQL_ASCII_SCCSID | 32 ビット整数 | Db2 DSNHDECP の ASCCSID フィールドに現在設定されている ASCII SCCSID 値を指定します。 |
| SQL_BATCH_ROW_COUNT | 32 ビット・マスク | 行カウントが使用できるかどうかを示します。Db2 ODBC は常に SQL_BRC_ROLLED_UP を戻し、これは連続
する INSERT、DELETE、または UPDATE ステートメントの行カウントが 1 つにまとめられることを
示します。ODBC は以下の値も定義していますが
、Db2 ODBC はこれらの値は戻しません。
|
| SQL_BATCH_SUPPORT | 32 ビット・マスク | サポートされるバッチのレベルを示します。
|
| SQL_BOOKMARK_PERSISTENCE | 32 ビット・マスク | 予約済み属性。ビット・マスクにはゼロが戻されます。 |
| SQL_CATALOG_LOCATION
(Db2 ODBC の前のバージョンでは、InfoType は SQL_QUALIFIER_LOCATION です。) |
16 ビット整数 | 修飾された表名の修飾子の位置を示す 16 ビット整数値。ゼロは、修飾名がサポートされないことを示します。 |
| SQL_CATALOG_NAME | ストリング (string) | 文字ストリング 'Y' は、サーバーがカタログ名をサポートすることを示します。 'N' は、カタログ名がサポートされないことを示します。 |
| SQL_CATALOG_NAME_SEPARATOR
(Db2 ODBC の前のバージョンでは、InfoType は SQL_QUALIFIER_NAME_SEPARATOR です。) |
ストリング (string) | カタログ名とその後に続く修飾名エレメントの間の区切り記号として使用される文字。 |
| SQL_CATALOG_TERM
(Db2 ODBC の前のバージョンでは、InfoType は SQL_QUALIFIER_TERM です。) |
ストリング (string) | データベース・ベンダーの修飾子用用語。
ベンダーが、3 部構成の名前の上位の部分に使用する名前。 Db2 ODBC では 3 部構成の名前がサポートされていないため、長さゼロのストリングが戻されます。 ODBC 以外のアプリケーションの場合、SQL_QUALIFIER_NAME の 代わりに SQL_CATALOG_TERM シンボル名を使用する必要があります。 |
| SQL_CATALOG_USAGE (Db2 ODBC の前のバージョンでは、InfoType は SQL_QUALIFIER_USAGE です。) | 32 ビット・マスク | これは SQL_OWNER_USAGE と同様ですが、カタログ用に使われます。 |
| SQL_COLLATION_SEQ | ストリング (string) | 照合順序の名前。これは、 このサーバーのデフォルト文字セットのデフォルト照合の名前を示す文字ストリング です (例えば EBCDIC)。 これが不明な場合は、空ストリングが戻されます。 |
| SQL_COLUMN_ALIAS | ストリング (string) | 列の別名がサポートされている場合は 'Y' が戻され、 サポートされていない場合は 'N' が戻されます。 |
| SQL_CONCAT_NULL_BEHAVIOR | 16 ビット整数 | NULL 値の文字データ・タイプの列と非 NULL 値の文字データ・タイプの
列の連結をどのように処理するかを示します。
|
| SQL_CONVERT_BIGINT
SQL_CONVERT_BINARY SQL_CONVERT_BIT SQL_CONVERT_CHAR SQL_CONVERT_DATE SQL_CONVERT_DECIMAL SQL_CONVERT_DOUBLE SQL_CONVERT_FLOAT SQL_CONVERT_INTEGER SQL_CONVERT_INTERVAL_DAY_TIME SQL_CONVERT_INTERVAL_YEAR_MONTH SQL_CONVERT_LONGVARBINARY SQL_CONVERT_LONGVARCHAR SQL_CONVERT_NUMERIC SQL_CONVERT_REAL SQL_CONVERT_ROWID SQL_CONVERT_SMALLINT SQL_CONVERT_TIME SQL_CONVERT_TIMESTAMP SQL_CONVERT_TINYINT SQL_CONVERT_VARBINARY SQL_CONVERT_VARCHAR |
32 ビット・マスク | データ・ソースがサポートする、
InfoType で指定されたタイプのデータに
対する CONVERT スカラー関数を使用した変換を示します。
ビット・マスクがゼロの場合、データ・ソースは、指定されたタイプのデータの
変換 (同じデータ・タイプへの変換も含めて) をサポートしません。
例えば、データ・ソースが SQL_INTEGER データから SQL_DECIMAL データ・タイプ への変換をサポートしているかどうかを調べるには、アプリケーション は SQL_CONVERT_INTEGER の InfoType を 用いて SQLGetInfo() を呼び出します。 その後、アプリケーションは、戻されたビット・マスクと SQL_CVT_DECIMAL の AND 演算を 行います。 結果の値がゼロでない場合は、変換はサポートされています。 以下のビット・マスクを使用して、サポートされている変換を判別します。
|
| SQL_CONVERT_FUNCTIONS | 32 ビット・マスク | ドライバーおよび関連データ・ソースが
サポートするスカラー変換関数を示します。
|
| SQL_CORRELATION_NAME | 16 ビット整数 | サーバーでサポートされる相関名の程度を示します。
|
| SQL_CLOSE_BEHAVIOR | 32 ビット整数 | カーソルがクローズされるときにロックが
解放されるかどうかを示します。 可能な値には、以下のものがあります。
|
| SQL_CREATE_ASSERTION | 32 ビット・マスク | CREATE ASSERTION ステートメント内のどの文節がデータベース管理システムにサポートされているかを示します。Db2 ODBC は常にゼロを戻します。CREATE ASSERTION ステートメントはサポートされていません。
ODBC は以下の値も定義していますが
、Db2 ODBC はこれらの値は戻しません。
|
| SQL_CREATE_CHARACTER_SET | 32 ビット・マスク | CREATE CHARACTER SET ステートメント内のどの文節がデータベース管理システムにサポートされているかを示します。Db2 ODBC は常にゼロを戻します。CREATE CHARACTER SET ステートメントは
サポートされていません。 ODBC は以下の値も定義していますが
、Db2 ODBC はこれらの値は戻しません。
|
| SQL_CREATE_COLLATION | 32 ビット・マスク | CREATE COLLATION ステートメント内のどの文節がデータベース管理システムにサポートされているかを示します。Db2 ODBC は常にゼロを戻します。CREATE COLLATION ステートメントはサポートされていません。
ODBC は以下の値も定義していますが
、Db2 ODBC はこれらの値は戻しません。
|
| SQL_CREATE_DOMAIN | 32 ビット・マスク | CREATE DOMAIN ステートメント内のどの文節がデータベース管理システムにサポートされているかを示します。Db2 ODBC は常にゼロを戻します。CREATE DOMAIN ステートメントはサポートされていません。
ODBC は以下の値も定義していますが
、Db2 ODBC はこれらの値は戻しません。
|
| SQL_CREATE_SCHEMA | 32 ビット・マスク | CREATE SCHEMA ステートメント内のどの文節がデータベース管理システムにサポートされているかを示します。
|
| SQL_CREATE_TABLE | 32 ビット・マスク | CREATE TABLE ステートメント内のどの文節がデータベース管理システムにサポートされているかを示します。以下のビット・マスクを使用して、サポートされている文節を判別します。
|
| SQL_CREATE_TRANSLATION | 32 ビット・マスク | CREATE TRANSLATION ステートメント内のどの文節がデータベース管理システムにサポートされているかを示します。Db2 ODBC は常にゼロを戻します。CREATE TRANSLATION ステートメントはサポートされていません。
ODBC は以下の値も定義していますが
、Db2 ODBC はこれらの値は戻しません。
|
| SQL_CURSOR_COMMIT_BEHAVIOR | 16 ビット整数 | COMMIT 操作がカーソルにどのような影響を与えるかを示します。 値は、以下のとおりです。
COMMIT の後で、位置付け更新または削除などのアクションを行うには、 その前に FETCH を出してカーソルを位置変更する必要があります。 |
| SQL_CURSOR_ROLLBACK_BEHAVIOR | 16 ビット整数 | ROLLBACK 操作がどのようにカーソルに影響を与えるかを示します。 値は、以下のとおりです。
Db2 サーバーには SQL_CB_PRESERVE プロパティーがありません。 |
| SQL_CURSOR_SENSITIVITY | 32 ビットの符号なし整数 | カーソル・センシティビティーのサポートを示します。
|
| SQL_DATA_SOURCE_NAME | ストリング (string) | SQLConnect() への入力でデータ・ソースとして使用される名前。または SQLDriverConnect() 接続ストリングの DSN キーワード値。 |
| SQL_DATA_SOURCE_READ_ONLY | ストリング (string) | "Y" の文字ストリングはデータベースを READ ONLY モードにセットさ れていること、"N" の文字ストリングは READ ONLY モードにセットさ れていないことを示します。 |
| SQL_DATABASE_NAME | ストリング (string) | 現在使用中のデータベースの名前。 また、この情報は IBM データベース管理システムの SELECT CURRENT SERVER によっても戻されます。 |
| SQL_database server_NAME | ストリング (string) | アクセスされているデータベース管理システム製品の名前。 |
| SQL_database server_VER | ストリング (string) | アクセスされるデータベース管理システム製品のバージョン。 'mm.vv.rrrr' 形式のストリング (ただし、mm はメジャー・バージョン、 vv はマイナー・バージョン、および rrrr はリリースです)。 例えば、"02.01.0000" は、メジャー・バージョン 2、マイナー・バージョン 1、リリース 0 と 変換されます。 |
| SQL_DDL_INDEX | 32 ビットの符号なし整数 | 索引の作成およびドロップのサポートを示します。
|
| SQL_DEFAULT_TXN_ISOLATION | 32 ビット・マスク | サポートされているデフォルトのトランザクション分離レベル。
以下のいずれかのマスクが戻されます。
|
| SQL_DESCRIBE_PARAMETER | STRING | パラメーターを記述できる場合 'Y'、記述できない場合 'N'。 |
| SQL_DRIVER_HDBC | 32 ビット | Db2 ODBC の現行のデータベース・ハンドル。 |
| SQL_DRIVER_HENV | 32 ビット | Db2 ODBC の環境ハンドル。 |
| SQL_DRIVER_HLIB | 32 ビット | 予約済み。 |
| SQL_DRIVER_HSTMT | 32 ビット | Db2 ODBC の現行接続に対する現行ステートメント・ハンドル。 |
| SQL_DRIVER_NAME | ストリング (string) | Db2 ODBC 実装のファイル名。 Db2 ODBC は NULL を戻します。 |
| SQL_DRIVER_ODBC_VER | ストリング (string) | ドライバーがサポートする ODBC のバージョン番号。 Db2 ODBC は「3.00」を戻します。 |
| SQL_DRIVER_VER | ストリング (string) | CLI ドライバーのバージョン。'mm.vv.rrrr' という書式のストリング
|
| SQL_DROP_ASSERTION | 32 ビット・マスク | DROP ASSERTION ステートメント内のどの文節がデータベース管理システムにサポートされているかを示します。
Db2 ODBC は常にゼロを戻します。DROP ASSERTION ステートメントはサポートされていません。
ODBC は以下の値も定義していますが
、Db2 ODBC はこれらの値は戻しません。
|
| SQL_DROP_CHARACTER_SET | 32 ビット・マスク | DROP CHARACTER SET ステートメント内のどの文節がデータベース管理システムにサポートされているかを示します。
Db2 ODBC は常にゼロを戻します。DROP CHARACTER SET ステートメントは
サポートされていません。 ODBC は以下の値も定義していますが
、Db2 ODBC はこれらの値は戻しません。
|
| SQL_DROP_COLLATION | 32 ビット・マスク | DROP COLLATION ステートメント内のどの文節がデータベース管理システムにサポートされているかを示します。
Db2 ODBC は常にゼロを戻します。DROP COLLATION ステートメントはサポートされていません。
ODBC は以下の値も定義していますが
、Db2 ODBC はこれらの値は戻しません。
|
| SQL_DROP_DOMAIN | 32 ビット・マスク | DROP DOMAIN ステートメント内のどの文節がデータベース管理システムにサポートされているかを示します。Db2 ODBC は常にゼロを戻します。DROP DOMAIN ステートメントはサポートされていません。
ODBC は以下の値も定義していますが
、Db2 ODBC はこれらの値は戻しません。
|
| SQL_DROP_SCHEMA | 32 ビット・マスク | DROP SCHEMA ステートメント内のどの文節がデータベース管理システムにサポートされているかを示します。
|
| SQL_DROP_TABLE | 32 ビット・マスク | DROP TABLE ステートメント内のどの文節がデータベース管理システムにサポートされているかを示します。
|
| SQL_DROP_TRANSLATION | 32 ビット・マスク | DROP TRANSLATION ステートメント内のどの文節がデータベース管理システムにサポートされているかを示します。Db2 ODBC は常にゼロを戻します。DROP TRANSLATION ステートメントはサポートされていません。
ODBC は以下の値も定義していますが
、Db2 ODBC はこれらの値は戻しません。
|
| SQL_DROP_VIEW | 32 ビット・マスク | DROP VIEW ステートメント内のどの文節がデータベース管理システムにサポートされているかを示します。
|
| SQL_DYNAMIC_CURSOR_ATTRIBUTES1 | 32 ビット・マスク | Db2 ODBC がサポートする動的カーソルの属性を示します (2 つのサブセットの中の 1 番目)。
|
| SQL_DYNAMIC_CURSOR_ATTRIBUTES2 | 32 ビット・マスク | Db2 ODBC がサポートする動的カーソルの属性を示します (2 つのサブセットの中の 2 番目)。
|
| SQL_EBCDIC_GCCSID | 32 ビット整数 | Db2 DSNHDECP の AGCCSID フィールドに現在設定されている EBCDIC GCCSID 値を指定します。 |
| SQL_EBCDIC_MCCSID | 32 ビット整数 | Db2 DSNHDECP の AMCCSID フィールドに現在設定されている EBCDIC MCCSID 値を指定します。 |
| SQL_EBCDIC_SCCSID | 32 ビット整数 | Db2 DSNHDECP の ASCCSID フィールドに現在設定されている EBCDIC SCCSID 値を指定します。 |
| SQL_EXPRESSIONS_IN_ORDERBY | ストリング (string) | 文字ストリング 'Y' は、データベース・サーバーが ORDER BY リストの 式で DIRECT の指定をサポートしていることを示し、'N' はそのサポートがないことを示します。 |
| SQL_FETCH_DIRECTION | 32 ビット・マスク | サポートされているフェッチ方向。
以下のビット・マスクをフラグと一緒に使用して、サポートされている属性値を判別します。
|
| SQL_FILE_USAGE | 16 ビット整数 | 予約済み。 ゼロが戻されます。 |
| SQL_FORWARD_ONLY_CURSOR_ATTRIBUTES1 | 32 ビット・マスク | Db2 ODBC がサポートする前方スクロール・カーソルの属性を示します (2 つのサブセットの中の 1 番目)。
|
| SQL_FORWARD_ONLY_CURSOR_ATTRIBUTES2 | 32 ビット・マスク | Db2 ODBC がサポートする前方スクロール・カーソルの属性を示します (2 つのサブセットの中の 2 番目)。
|
| SQL_GETDATA_EXTENSIONS | 32 ビット・マスク | SQLGetData() 関数の拡張がサポートされているかどうかを示します。
Db2 ODBC では、現在、以下の拡張機能が確認されており、サポートされています。
ODBC では、Db2 ODBC によって戻されない、以下の拡張機能も定義します。
|
| SQL_GROUP_BY | 16 ビット整数 | サーバーによる GROUP BY 文節のサポートの程度を示します。
|
| SQL_IDENTIFIER_CASE | 16 ビット整数 | オブジェクト名 (例えば、表名) の大/小文字の区別を示します。
値は、以下のとおりです。
IBM 固有: IBM データベース管理システムの ID 名は大/小文字の区別がありません。 |
| SQL_IDENTIFIER_QUOTE_CHAR | ストリング (string) | 区切り ID を囲むために使用される文字を示します。 |
| SQL_INFO_SCHEMA_VIEWS | 32 ビット・マスク | サポートされる INFORMATIONAL_SCHEMA 内のビューを示します。
Db2 ODBC は常にゼロを戻します。INFORMATIONAL_SCHEMA 内のビューはサポートされません。ODBC は以下の値も定義していますが
、Db2 ODBC はこれらの値は戻しません。
|
| SQL_INSERT_STATEMENT | 32 ビット・マスク | INSERT ステートメントのサポートを示します。
|
| SQL_INTEGRITY (Db2 ODBC の前のバージョンでは、InfoType は SQL_ODBC_SQL_OPT_IEF でした。) | ストリング (string) | 'Y' は SQL89 および X/Open XPG4 組み込み SQL で データ・ソースが保全性拡張機能 (IEF) をサポートしていることを示し、'N' は そのサポートがないことを示します。 |
| SQL_KEYSET_CURSOR_ATTRIBUTES1 | 32 ビット・マスク | Db2 ODBC がサポートするキーセット・カーソルの属性を示します (2 つのサブセットの中の 1 番目)。
|
| SQL_KEYSET_CURSOR_ATTRIBUTES2 | 32 ビット・マスク | Db2 ODBC がサポートするキーセット・カーソルの属性を示します (2 つのサブセットの中の 2 番目)。
|
| SQL_KEYWORDS | ストリング (string) | ODBC の予約語一覧にない、そのデータベース管理システムにおける全キーワードのストリングです。 |
| SQL_LIKE_ESCAPE_CLAUSE | ストリング (string) | LIKE 述部のメタキャラクター・パーセントと下線 についてエスケープ文字がサポートされているかどうかを示す文字ストリング。 |
| SQL_LOCK_TYPES | 32 ビット・マスク | 予約済み属性。ビット・マスクにはゼロが戻されます。 |
| SQL_MAX_ASYNC_CONCURRENT_STATEMENTS | 32 ビットの符号なし整数 | 与えられた接続について、Db2 ODBC がサポートできる、 非同期モード内のアクティブな並行ステートメントの最大数。具体的な限度がないかまたは不明な場合、この値はゼロです。 |
| SQL_MAX_BINARY_LITERAL_LEN | 32 ビット整数 | SQL ステートメントの 16 進数リテラルの 最大長を指定する 32 ビットの整数値。 |
| SQL_MAX_CATALOG_NAME_LEN (Db2 ODBC の前のバージョン では、InfoType は SQL_MAX_QUALIFIER_NAME_LEN です。) | 16 ビット整数 | カタログ修飾子名、すなわち 3 部構成の表名の最初の部分、の最大長 (バイト)。 |
| SQL_MAX_CHAR_LITERAL_LEN | 32 ビット整数 | SQL ステートメントの文字リテラルの最大長 (バイト単位)。 |
| SQL_MAX_COLUMN_NAME_LEN | 16 ビット整数 | 列名の最大長 (バイト単位)。 |
| SQL_MAX_COLUMNS_IN_GROUP_BY | 16 ビット整数 | サーバーが GROUP BY 文節でサポートする列の最大数を示します。 限度がない場合はゼロです。 |
| SQL_MAX_COLUMNS_IN_INDEX | 16 ビット整数 | サーバーが索引でサポートする列の最大数を示します。 限度がない場合はゼロです。 |
| SQL_MAX_COLUMNS_IN_ORDER_BY | 16 ビット整数 | サーバーが ORDER BY 文節でサポートする列の最大数を示します。限度がない場合はゼロです。 |
| SQL_MAX_COLUMNS_IN_SELECT | 16 ビット整数 | サーバーが選択リストでサポートする列の最大数を示します。 限度がない場合はゼロです。 |
| SQL_MAX_COLUMNS_IN_TABLE | 16 ビット整数 | サーバーが基本表でサポートする列の最大数を示します。 限度がない場合はゼロです。 |
| SQL_MAX_CONCURRENT_ACTIVITIES (Db2 ODBC の前のバージョンでは、InfoType は SQL_ACTIVE_STATEMENTS です。) | 16 ビット整数 | 接続ごとのアクティブ・ステートメントの最大数。
ゼロが戻された場合は、限度はデータベース・システムおよび Db2 ODBC の リソースと限度によって異なることを示しています。 |
| SQL_MAX_CURSOR_NAME_LEN | 16 ビット整数 | カーソル名の最大長 (バイト単位)。 |
| SQL_MAX_DRIVER_CONNECTIONS (Db2 ODBC の前のバージョンでは、InfoType は SQL_ACTIVE_CONNECTIONS です。) | 16 ビット整数 | アプリケーションごとにサポートされているアクティブ接続の最大数。
ゼロが戻された場合は、限度はシステム・リソースによって異なることを 示しています。 初期化ファイルの MAXCONN キーワードまたは SQL_MAX_CONNECTIONS 環境 および接続属性を使用して、接続数の限度を定めることができます。 限度がゼロ以外の値に設定されていると、その限界が戻されます。 |
| SQL_MAX_IDENTIFIER_LEN | 16 ビット整数 | データ・ソースがサポートするユーザー定義名の最大サイズ (文字数)。 |
| SQL_MAX_INDEX_SIZE | 32 ビット整数 | ある索引の中で組み合わされた列に対して サーバーがサポートする最大サイズをバイト単位で示します。限度がない場合はゼロです。 |
| SQL_MAX_PROCEDURE_NAME_LEN | 16 ビット整数 | プロシージャー名の最大長 (バイト単位)。 |
| SQL_MAX_ROW_SIZE | 32 ビット整数 | サーバーが基本表の単一の行でサポートする最大長 (バイト) を指定します。 限度がない場合はゼロです。 |
| SQL_MAX_ROW_SIZE_INCLUDES_LONG | ストリング (string) | SQLGetInfo() (InfoType に SQL_MAX_ROW_SIZE を設定) に製品固有の LONG ストリング ・データ・タイプの長さが含まれている場合、「Y」を戻します。それ以外の場合は、'N' が戻されます。 |
| SQL_MAX_SCHEMA_NAME_LEN (Db2 ODBC の前のバージョン では、InfoType は SQL_MAX_OWNER_NAME_LEN です。) | 16 ビット整数 | スキーマ修飾子名の最大長 (バイト単位)。 |
| SQL_MAX_STATEMENT_LEN | 32 ビット整数 | ステートメント内の空白の数を含む SQL ステートメント・ストリングの最大長 (バイト) で示します。 |
| SQL_MAX_TABLE_NAME_LEN | 16 ビット整数 | 表名の最大長 (バイト単位)。 |
| SQL_MAX_TABLES_IN_SELECT | 16 ビット整数 | <照会仕様> の FROM 文節に 使用できる表名の最大長を示します。 |
| SQL_MAX_USER_NAME_LEN | 16 ビット整数 | <ユーザー ID> に使用できる最大サイズ (バイト) を示します。 |
| SQL_MULT_RESULT_SETS | ストリング (string) | 文字ストリング 'Y' は、 データベースが複数の結果セットをサポートしていることを示し、'N' はそれを サポートしていないことを示します。 |
| SQL_MULTIPLE_ACTIVE_TXN | ストリング | 文字ストリング「Y」は、複数の接続でアクティブ・トランザクションが許されることを示します。「N」は、一度に 1 つの接続のみがアクティブ・トランザクションを持てることを示しています。 |
| SQL_NEED_LONG_DATA_LEN | ストリング (string) | ODBC を使用するために予約されている文字ストリングです。常に「N」が戻されます。 |
| SQL_NON_NULLABLE_COLUMNS | 16 ビット整数 | NULL 不可列がサポートされているかどうかを示します。
|
| SQL_NULL_COLLATION | 16 ビット整数 | リスト中で NULL 値がソートされる場所を示します。
|
| SQL_NUMERIC_FUNCTIONS | 32 ビット・マスク | ODBC スカラー数字関数がサポートされることを示します。
これらの関数は ODBC ベンダー・エスケープ・シーケンスとともに使用することを目的としています。 以下のビット・マスクを使用して、サポートされている数字関数を判別します。
|
| SQL_ODBC_API_CONFORMANCE | 16 ビット整数 | ODBC 適合性のレベル。
|
| SQL_ODBC_SAG_CLI_CONFORMANCE | 16 ビット整数 | SQL アクセス・グループ (SAG) CLI 仕様の関数への適合性。
値は、以下のとおりです。
|
| SQL_ODBC_SQL_CONFORMANCE | 16 ビット整数 | 値は、以下のとおりです。
|
| SQL_ODBC_VER | ストリング (string) | ドライバー・マネージャーがサポートする ODBC のバージョン番号。
Db2 ODBC はストリング「03.01.0000」を戻します。 |
| SQL_OJ_CAPABILITIES | 32 ビット・マスク | サポートされている外部結合タイプを
列挙する 32 ビット・マスク。
ビット・マスクは以下のとおりです。
|
| SQL_ORDER_BY_COLUMNS_IN_SELECT | ストリング (string) | ORDER BY 文節の列を選択リストに入れる 必要がある場合は 'Y' に設定し、必要ない場合は 'N' に設定します。 |
| SQL_OUTER_JOINS | ストリング (string) | 以下の文字ストリング。
|
| SQL_OWNER_TERM (Db2 ODBC の前のバージョンでは、InfoType は SQL_SCHEMA_TERM です。) | ストリング (string) | データベース・ベンダーの (所有者の) スキーマの用語 |
| SQL_PARAM_ARRAY_ROW_COUNTS | 32 ビットの符号なし整数 | パラメーターを使用する実行において、どのような行数が使用できるかを示します。
|
| SQL_PARAM_ARRAY_SELECTS | 32 ビットの符号なし整数 | パラメーターを使用する実行において、
どのような結果セットが使用できるかを示します。
|
| SQL_POS_OPERATIONS | 32 ビット・マスク | 予約済み属性。ビット・マスクにはゼロが戻されます。 |
| SQL_POSITIONED_STATEMENTS | 32 ビット・マスク | 位置付け UPDATE および位置付け DELETE ステートメント
がサポートされている程度を示します。
|
| SQL_PROCEDURE_TERM | ストリング (string) | データベース・ベンダーがプロシージャー用に使用している名前。 |
| SQL_PROCEDURES | ストリング (string) | 「Y」は、データ・ソースがプロシージャーをサポートしており、Db2 ODBC が ODBC プロシージャー呼び出し構文をサポートしていることを示します。「N」は、サポートしていないことを示します。 |
| SQL_QUOTED_IDENTIFIER_CASE | 16 ビット整数 | 以下を戻します。
|
| SQL_ROW_UPDATES | ストリング (string) | 文字ストリング「Y」は、同じ行を複数回フェッチする間に、行の変更が検出されることを示します。「N」は、変更が検出されないことを示します。 |
| SQL_SCHEMA_USAGE (Db2 ODBC の前のバージョンでは、InfoType は SQL_OWNER_USAGE です。) | 32 ビット・マスク | SQL ステートメントの実行時に、
関連したスキーマ (所有者) のあるステートメントのタイプを示します。
スキーマ修飾子 (所有者) のサポートは、以下のとおりです。
|
| SQL_SCROLL_CONCURRENCY | 32 ビット・マスク | カーソル用にサポートされている並行性のオプションを示します。 以下のビット・マスクをフラグと一緒に使用して、サポートされている属性値を判別します。
Db2 ODBC は、SQL_SCCO_LOCK を戻します。これは、使用されるロッキングのレベルに、行を確実に更新するのに十分な、最低レベルのロッキングを使用することを示しています。 |
| SQL_SCROLL_OPTIONS | 32 ビット・マスク | 両方向スクロール・カーソルをサポートするスクロール・オプションです。 以下のビット・マスクをフラグと一緒に使用して、サポートされている属性値を判別します。
|
| SQL_SEARCH_PATTERN_ESCAPE | ストリング (string) | カタログ関数用 (SQLTables()、SQLColumns() など) の エスケープ文字として、ドライバーがサポートするものを指定するために使用されます。 |
| SQL_SERVER_NAME | ストリング (string) | アプリケーションが接続されている Db2 サブシステムの名前。 |
| SQL_SPECIAL_CHARACTERS | ストリング (string) | 非区切り ID でサーバーが許可する すべての文字を含みます。 これには、a...z, A...Z, 0...9、および _ が含まれます。 |
| SQL_SQL92_PREDICATES | 32 ビット・マスク | ANSI/ISO
SQL 規格 (1992) により定義され、SELECT ステートメントでサポートされる
以下の述部を示します。
|
| SQL_SQL92_VALUE_EXPRESSIONS | 32 ビット・マスク | SQL92 により定義され、サポートされる以下の値式を示します。
|
| SQL_STATIC_CURSOR_ATTRIBUTES1 | 32 ビット・マスク | Db2 ODBC がサポートする静的カーソルの属性を示します (2 つのサブセットの中の 1 番目)。
|
| SQL_STATIC_CURSOR_ATTRIBUTES2 | 32 ビット・マスク | Db2 ODBC がサポートする静的カーソルの属性を示します (2 つのサブセットの中の 2 番目)。
|
| SQL_STATIC_SENSITIVITY | 32 ビット・マスク | アプリケーションが位置付け UPDATE または位置付け DELETE ステートメント
を使用して行った変更を、そのアプリケーションが検出できるかどうかを示します。
|
| SQL_STRING_FUNCTIONS | 32 ビット・マスク | サポートされるストリング関数を示します。
以下のビット・マスクを使用して、サポートされているストリング関数を判別します。
アプリケーションが、引数 string1、string2、および start を 用いて LOCATE スカラー関数を呼び出せる場合は、SQL_FN_STR_LOCATE ビット・マスクが戻されます。 アプリケーションが、string1 および string2 を用いた LOCATE スカラー関数しか 呼び出せない場合は、SQL_FN_STR_LOCATE_2 ビット・マスクが戻されます。 LOCATE スカラー関数が完全にサポートされている場合は、両方のビット・マスクが戻されます。 |
| SQL_SUBQUERIES | 32 ビット・マスク | 副照会をサポートしている述部を示します。
|
| SQL_SYSTEM_FUNCTIONS | 32 ビット・マスク | サポートされるスカラー・システム関数を示します。
以下のビット・マスクを使用して、サポートされているスカラー・システム関数を判別します。
ヒント: これらの関数は、ODBC のエスケープ・シーケンスとともに 使用するためのものです。 |
| SQL_TABLE_TERM | ストリング (string) | データベース・ベンダーの表用の用語。 |
| SQL_TIMEDATE_ADD_INTERVALS | 32 ビット・マスク | 特殊な ODBC システム関数 TIMESTAMPADD がサポートされている
かどうか、サポートされている場合はサポートされている時間間隔を示します。
以下のビット・マスクを使用して、サポートされている時間間隔を判別します。
|
| SQL_TIMEDATE_DIFF_INTERVALS | 32 ビット・マスク | 特殊な ODBC システム関数 TIMESTAMPDIFF がサポートされている
かどうか、サポートされている場合はサポートされている時間間隔を示します。
以下のビット・マスクを使用して、サポートされている時間間隔を判別します。
|
| SQL_TIMEDATE_FUNCTIONS | 32 ビット・マスク | サポートされる日付と時間の関数を示します。
以下のビット・マスクを使用して、サポートされている日付関数を判別します。
ヒント: これらの関数は、ODBC のエスケープ・シーケンスとともに 使用するためのものです。 |
| SQL_TXN_CAPABLE | 16 ビット整数 | トランザクションが、データ定義言語またはデータ操作言語、あるいはその両方を含むことができるかどうかを示します。
|
| SQL_TXN_ISOLATION_OPTION | 32 ビット・マスク | 現在接続中のデータベース・サーバーで使用できるトランザクション分離レベル。
以下のビット・マスクをフラグと一緒に使用して、サポートされている属性値を判別します。
|
| SQL_UNICODE_GCCSID | 32 ビット整数 | Db2 DSNHDECP の UGCCSID フィールドに現在設定されている UNICODE GCCSID 値を指定します。 |
| SQL_UNICODE_MCCSID | 32 ビット整数 | Db2 DSNHDECP の UMCCSID フィールドに現在設定されている UNICODE MCCSID 値を指定します。 |
| SQL_UNICODE_SCCSID | 32 ビット整数 | Db2 DSNHDECP の USCCSID フィールドに現在設定されている UNICODE SCCSID 値を指定します。 |
| SQL_UNION | 32 ビット・マスク | サーバーが UNION 演算子をサポートしているかどうかを示します。
|
| SQL_USER_NAME | ストリング (string) | 特定のデータベースで使用されるユーザー名。 これは SQLConnect() 呼び出しで指定される ID です。 |
| SQL_XOPEN_CLI_YEAR | ストリング (string) | ドライバーのバージョンが完全に準拠する X/Open 仕様の公表の年を示します。 |
戻りコード
- SQL_SUCCESS
- SQL_SUCCESS_WITH_INFO
- SQL_ERROR
- SQL_INVALID_HANDLE
診断
次の表は、この関数が生成する各 SQLSTATE 値ごとに、 その記述と説明を一覧で記載してあります。
| SQLSTATE | 説明 | 説明 |
|---|---|---|
| 01004 | データが切り捨てられました。 | 要求情報はストリングとして戻されましたが、その長さが引数 BufferLength で指定 されているアプリケーション・バッファーの長さを超えています。 引数 StringLengthPtr には、要求情報の実際の (切り捨てられていない) 長さ (バイト) が 含まれています。(SQLGetInfo() は、この SQLSTATE で SQL_SUCCESS_WITH_INFO を戻します。) |
| 08003 | 接続はクローズされています。 | 引数 InfoType が要求する情報のタイプが、オープン接続を必要としています。 オープン接続が必要ないのは、SQL_ODBC_VER のみです。 |
| 08S01 | 通信リンクに障害が起きました。 | 関数が完了する前に、アプリケーションとデータ・ソース間の 通信リンクで障害が発生しました。 |
| 58004 | 予期しないシステム障害です。 | リカバリー不能なシステム・エラーです。 |
| HY001 | メモリーの割り振りに失敗しました。 | Db2 ODBC は、関数の実行または完了をサポートするのに必要なメモリーを割り振ることができません。 |
| HY090 | ストリングまたはバッファーの長さが無効です。 | 引数 BufferLength に指定された値は 0 より小さい値です。 |
| HY096 | 情報のタイプが無効です。 | 引数 InfoType に無効な値が指定されています。 |
| HYC00 | ドライバーは使用できません。 | 引数 InfoType に指定された値は、Db2 ODBC でもデータ・ソースでもサポートされていません。 |
例
SQLCHAR buffer[255];
SQLSMALLINT outlen;
rc = SQLGetInfo(hdbc, SQL_DATA_SOURCE_NAME, buffer, 255, &outlen);
printf("¥nServer Name: %s¥n", buffer);