SQLGetInfo() - 一般情報を取得する

SQLGetInfo() は、アプリケーションが現在接続されているデータベース管理システムに関する一般情報を戻します。 例えば、SQLGetInfo() は、 どのようなデータ変換がサポートされているかを示します。

SQLGetInfo() の ODBC 仕様

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

構文

SQLRETURN SQLGetInfo (SQLHDBC       ConnectionHandle,
                      SQLUSMALLINT  InfoType,
                      SQLPOINTER    InfoValuePtr,
                      SQLSMALLINT   BufferLength,
                      SQLSMALLINT   *FAR StringLengthPtr);

関数の引数

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

表 2. SQLGetInfo() の引数
データ・タイプ 引数 使用法 説明
SQLHDBC ConnectionHandle 入力 接続ハンドルを指定します。
SQLUSMALLINT InfoType 入力 要求する情報のタイプを指定します。この引数は、表 3 の最初の欄にある値 のいずれかでなければなりません。
SQLPOINTER InfoValuePtr 出力 (および入力) この関数が取り出された情報を保管するバッファーを指します。 取り出す情報のタイプによって、次の 5 つのタイプの情報が戻されます。
  • 16 ビット整数値
  • 32 ビット整数値
  • 32 ビット 2 進数値
  • 32 ビット・マスク
  • NUL 終了文字ストリング
SQLSMALLINT BufferLength 入力 引数 InfoValuePtr が指すバッファーの最大長 (バイト) を指定します。
SQLSMALLINT * StringLengthPtr 出力 出力情報が切り捨てられないようにするのに必要なバイト数を、この関数が戻すためのバッファーを指します。 ストリング出力の場合、このサイズには NUL 終止符は含まれません。

StringLengthPtr が指しているロケーションの値が 、BufferLength に指定されている InfoValuePtr バッファーのサイズよりも 大きい場合は、ストリング出力情報は BufferLength - 1 バイトに切り捨てられ、 この関数は SQL_SUCCESS_WITH_INFO を戻します。

使用法

表 3 は、引数 InfoType の可能な値 と SQLGetInfo() がその値について戻す情報の説明を示しています。この表では、ODBC 3.0 で 名前変更になった引数 InfoType を示しています。

重要: 引数 InfoType に指定された値が 適用されないか、サポートされていない場合、その結果は戻りのタイプによって異なります。引数 InfoType でサポートされないそれぞれのタイプごとに、 以下の値が戻されます。
  • 'Y' または 'N' を含む文字ストリングの場合は、'N' が戻されます。
  • 'Y' または 'N' 以外の値のみを含む文字ストリングの場合は、空ストリングが戻されます。
  • 16 ビット整数の場合は、0 (ゼロ) が戻されます。
  • 32 ビット整数の場合は、0 (ゼロ) が戻されます。
  • 32 ビット・マスクの場合は、0 (ゼロ) が戻されます。
次の表では、引数 InfoType で指定できるそれぞれの値を明示しており、 さらにそれぞれの値が戻す情報について説明しています。
表 3. SQLGetInfo() によって戻される情報
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_AF_ALL
  • SQL_AF_AVG
  • SQL_AF_COUNT
  • SQL_AF_DISTINCT
  • SQL_AF_MAX
  • SQL_AF_MIN
  • SQL_AF_SUM
SQL_ALTER_DOMAIN 32 ビット・マスク Db2 ODBC は、ALTER DOMAIN ステートメントがサポートされていないことを示す 0 を戻します。ODBC は以下の値も定義していますが 、Db2 ODBC はこれらの値は戻しません。
  • SQL_AD_ADD_CONSTRAINT_DEFERRABLE
  • SQL_AD_ADD_CONSTRAINT_NON_DEFERRABLE
  • SQL_AD_ADD_CONSTRAINT_INITIALLY_DEFERRED
  • SQL_AD_ADD_CONSTRAINT_INITIALLY_IMMEDIATE
  • SQL_AD_ADD_DOMAIN_CONSTRAINT
  • SQL_AD_ADD_DOMAIN_DEFAULT
  • SQL_AD_CONSTRAINT_NAME_DEFINITION
  • SQL_AD_DROP_DOMAIN_CONSTRAINT
  • SQL_AD_DROP_DOMAIN_DEFAULT
SQL_ALTER_TABLE 32 ビット・マスク ALTER TABLE 中のどの文節がデータベース管理システムにサポートされているかを示します。
  • SQL_AT_ADD_COLUMN
  • SQL_AT_DROP_COLUMN
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_BRC_PROCEDURES
  • SQL_BRC_EXPLICIT
SQL_BATCH_SUPPORT 32 ビット・マスク サポートされるバッチのレベルを示します。
  • SQL_BS_SELECT_EXPLICIT は、 結果セット生成ステートメントを持つことができる明示的バッチをサポートします。
  • SQL_BS_ROW_COUNT_EXPLICIT は、 行数生成ステートメントを持つことができる明示的バッチをサポートします。
  • SQL_BS_SELECT_PROC は、 結果セット生成ステートメントを持つことができる明示的プロシージャーをサポートします。
  • SQL_BS_ROW_COUNT_PROC は、 行数生成ステートメントを持つことができる明示的プロシージャーをサポートします。
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_CB_NULL - 結果が NULL 値であることを示します (IBM® リレーショナル・データベース管理システムの場合)。
  • SQL_CB_NON_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_CVT_BIGINT
  • SQL_CVT_BINARY
  • SQL_CVT_BIT
  • SQL_CVT_CHAR
  • SQL_CVT_DATE
  • SQL_CVT_DECIMAL
  • SQL_CVT_DOUBLE
  • SQL_CVT_FLOAT
  • SQL_CVT_INTEGER
  • SQL_CVT_LONGVARBINARY
  • SQL_CVT_LONGVARCHAR
  • SQL_CVT_NUMERIC
  • SQL_CVT_REAL
  • SQL_CVT_ROWID
  • SQL_CVT_SMALLINT
  • SQL_CVT_TIME
  • SQL_CVT_TIMESTAMP
  • SQL_CVT_TINYINT
  • SQL_CVT_VARBINARY
  • SQL_CVT_VARCHAR
SQL_CONVERT_FUNCTIONS 32 ビット・マスク ドライバーおよび関連データ・ソースが サポートするスカラー変換関数を示します。
  • SQL_FN_CVT_CONVERT - どの変換関数がサポートされているかを判別するために使用します。
  • SQL_FN_CVT_CAST - どの cast 関数がサポートされているかを判別するために使用します。
SQL_CORRELATION_NAME 16 ビット整数 サーバーでサポートされる相関名の程度を示します。
  • SQL_CN_ANY: 相関名がサポートされており、任意の有効なユーザー 定義名にすることができます。
  • SQL_CN_NONE: 相関名はサポートされていません。
  • SQL_CN_DIFFERENT: 相関名はサポートされていますが、その名前が 表している表の名前と違う名前でなければなりません。
SQL_CLOSE_BEHAVIOR 32 ビット整数 カーソルがクローズされるときにロックが 解放されるかどうかを示します。 可能な値には、以下のものがあります。
  • SQL_CC_NO_RELEASE: このステートメント・ ハンドルに関連したカーソルのクローズ時に、ロックは解放されません。これはデフォルトです。
  • SQL_CC_RELEASE: このステートメント・ハンドルに関連したカーソルの クローズ時に、ロックが解放されます。
一般的に、fOption を SQL_CLOSE に設定して、関数 SQLFreeStmt() を 呼び出すと、あるいは SQLFreeHandle() を用いてステートメント・ハンドルが解放されると、カーソルは明示的にクローズされます。また、トランザクションが終了した場合 (コミットまたはロールバックが 出されたときに) も、カーソルがクローズされることがあります (現在使用中 の WITH HOLD 属性によって異なります)。
SQL_CREATE_ASSERTION 32 ビット・マスク CREATE ASSERTION ステートメント内のどの文節がデータベース管理システムにサポートされているかを示します。Db2 ODBC は常にゼロを戻します。CREATE ASSERTION ステートメントはサポートされていません。 ODBC は以下の値も定義していますが 、Db2 ODBC はこれらの値は戻しません。
  • SQL_CA_CREATE_ASSERTION
  • SQL_CA_CONSTRAINT_INITIALLY_DEFERRED
  • SQL_CA_CONSTRAINT_INITIALLY_IMMEDIATE
  • SQL_CA_CONSTRAINT_DEFERRABLE
  • SQL_CA_CONSTRAINT_NON_DEFERRABLE
SQL_CREATE_CHARACTER_SET 32 ビット・マスク CREATE CHARACTER SET ステートメント内のどの文節がデータベース管理システムにサポートされているかを示します。Db2 ODBC は常にゼロを戻します。CREATE CHARACTER SET ステートメントは サポートされていません。 ODBC は以下の値も定義していますが 、Db2 ODBC はこれらの値は戻しません。
  • SQL_CCS_CREATE_CHARACTER_SET
  • SQL_CCS_COLLATE_CLAUSE
  • SQL_CCS_LIMITED_COLLATION
SQL_CREATE_COLLATION 32 ビット・マスク CREATE COLLATION ステートメント内のどの文節がデータベース管理システムにサポートされているかを示します。Db2 ODBC は常にゼロを戻します。CREATE COLLATION ステートメントはサポートされていません。 ODBC は以下の値も定義していますが 、Db2 ODBC はこれらの値は戻しません。
  • SQL_CCOL_CREATE_COLLATION
SQL_CREATE_DOMAIN 32 ビット・マスク CREATE DOMAIN ステートメント内のどの文節がデータベース管理システムにサポートされているかを示します。Db2 ODBC は常にゼロを戻します。CREATE DOMAIN ステートメントはサポートされていません。 ODBC は以下の値も定義していますが 、Db2 ODBC はこれらの値は戻しません。
  • SQL_CDO_CREATE_DOMAIN
  • SQL_CDO_CONSTRAINT_NAME_DEFINITION
  • SQL_CDO_DEFAULT
  • SQL_CDO_CONSTRAINT
  • SQL_CDO_COLLATION
  • SQL_CDO_CONSTRAINT_INITIALLY_DEFERRED
  • SQL_CDO_CONSTRAINT_INITIALLY_IMMEDIATE
  • SQL_CDO_CONSTRAINT_DEFERRABLE
  • SQL_CDO_CONSTRAINT_NON_DEFERRABLE
SQL_CREATE_SCHEMA 32 ビット・マスク CREATE SCHEMA ステートメント内のどの文節がデータベース管理システムにサポートされているかを示します。
  • SQL_CS_CREATE_SCHEMA
  • SQL_CS_AUTHORIZATION
  • SQL_CS_DEFAULT_CHARACTER_SET
SQL_CREATE_TABLE 32 ビット・マスク CREATE TABLE ステートメント内のどの文節がデータベース管理システムにサポートされているかを示します。以下のビット・マスクを使用して、サポートされている文節を判別します。
  • SQL_CT_CREATE_TABLE
  • SQL_CT_TABLE_CONSTRAINT
  • SQL_CT_CONSTRAINT_NAME_DEFINITION
次のビットは、どのような一時表を作成できるかを指定します。
  • SQL_CT_COMMIT_PRESERVE は、削除された行がコミットで保持されます。
  • SQL_CT_COMMIT_DELETE は、削除された行がコミットで削除されます。
  • SQL_CT_GLOBAL_TEMPORARY は、グローバルな一時表を作成することができます。
  • SQL_CT_LOCAL_TEMPORARY は、ローカルな一時表を作成することができます。
次のビットは、どのような列制約を作成できるかを指定します。
  • SQL_CT_COLUMN_CONSTRAINT は、列制約がサポートされることを指定します。
  • SQL_CT_COLUMN_DEFAULT は列のデフォルトがサポートされることを指定します。
  • SQL_CT_COLUMN_COLLATION は、列の照合がサポートされることを指定します。
次のビットは、指定した列または表の制約がサポートされる場合、 サポートされる制約属性を指定します。
  • SQL_CT_CONSTRAINT_INITIALLY_DEFERRED
  • SQL_CT_CONSTRAINT_INITIALLY_IMMEDIATE
  • SQL_CT_CONSTRAINT_DEFERRABLE
  • SQL_CT_CONSTRAINT_NON_DEFERRABLE
SQL_CREATE_TRANSLATION 32 ビット・マスク CREATE TRANSLATION ステートメント内のどの文節がデータベース管理システムにサポートされているかを示します。Db2 ODBC は常にゼロを戻します。CREATE TRANSLATION ステートメントはサポートされていません。 ODBC は以下の値も定義していますが 、Db2 ODBC はこれらの値は戻しません。
  • SQL_CTR_CREATE_TRANSLATION
SQL_CURSOR_COMMIT_BEHAVIOR 16 ビット整数 COMMIT 操作がカーソルにどのような影響を与えるかを示します。 値は、以下のとおりです。
  • SQL_CB_DELETE: カーソルは破棄され、動的 SQL ステートメントに関する アクセス・プランがドロップされます。
  • SQL_CB_CLOSE: カーソルは破棄されますが、(非照会ステートメントを 含む) 動的 SQL ステートメントに関するアクセス・プランは保存されます。
  • SQL_CB_PRESERVE: カーソルと、(非照会ステートメントを 含む) 動的ステートメントに関するアクセス・プランは保存されます。 アプリケーションは、引き続きデータをフェッチするか、またはカーソルを クローズしてステートメントを再準備せずに照会を再実行できます。

COMMIT の後で、位置付け更新または削除などのアクションを行うには、 その前に FETCH を出してカーソルを位置変更する必要があります。

SQL_CURSOR_ROLLBACK_BEHAVIOR 16 ビット整数 ROLLBACK 操作がどのようにカーソルに影響を与えるかを示します。 値は、以下のとおりです。
  • SQL_CB_DELETE: カーソルは破棄され、動的 SQL ステートメントに関する アクセス・プランがドロップされます。
  • SQL_CB_CLOSE: カーソルは破棄されますが、(非照会ステートメントを 含む) 動的 SQL ステートメントに関するアクセス・プランは保存されます。
  • SQL_CB_PRESERVE: カーソルと、(非照会ステートメントを 含む) 動的ステートメントに関するアクセス・プランは保存されます。 アプリケーションは、引き続きデータをフェッチするか、またはカーソルを クローズしてステートメントを再準備せずに照会を再実行できます。

Db2 サーバーには SQL_CB_PRESERVE プロパティーがありません。

SQL_CURSOR_SENSITIVITY 32 ビットの符号なし整数 カーソル・センシティビティーのサポートを示します。
  • SQL_INSENSITIVE

    ステートメント・ハンドル上のすべてのカーソルが、 同じトランザクション内の別のカーソルによって結果セットが変更されても、 それを反映することなく結果セットを示します。

  • SQL_UNSPECIFIED

    ステートメント・ハンドル上のカーソルが、 同じトランザクション内の別のカーソルによって結果セットに変更が加えられたことを 認識できるようにするかどうかは、指定されません。ステートメント・ハンドル上のカーソルは、このような変更をまったく認識しない場合も、 そのいくつかを認識する場合も、あるいはすべてを認識する場合もあります。

  • SQL_SENSITIVE

    カーソルは同じトランザクション内の別のカーソルにより 行われる変更を反映します。

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_DI_CREATE_INDEX
  • SQL_DI_DROP_INDEX
SQL_DEFAULT_TXN_ISOLATION 32 ビット・マスク サポートされているデフォルトのトランザクション分離レベル。
以下のいずれかのマスクが戻されます。
  • SQL_TXN_READ_UNCOMMITTED = 変更が行われると、すべてのトランザクションが ただちにそれを認識します (ダーティー読み取り、反復不能読み取り、 および単独読み取りが可能です)。

    これは IBM の UR レベルに相当します。

  • SQL_TXN_READ_COMMITTED = トランザクション 1 による行読み取りを、 トランザクション 2 によって変更およびコミットすることが できます (反復不能読み取りおよび単独読み取りが可能です)。

    これは IBM の CS レベルに相当します。

  • SQL_TXN_REPEATABLE_READ = トランザクションは、検索条件に一致する 行またはペンディング中のトランザクションの追加あるいは除去が可能です (反復可能読み取りと単独読み取りが可能です)。

    これは IBM の RS レベルに相当します。

  • SQL_TXN_SERIALIZABLE = ペンディング中のトランザクションによる影響を受けた データは他のトランザクションでは使用できません (反復可能読み取り、 単独読み取りはできません)。

    これは IBM の RR レベルに相当します。

  • SQL_TXN_VERSIONING = IBM データベース管理システムには適用されません。
  • SQL_TXN_NOCOMMIT = 操作が正常終了したときに、変更内容はいずれも 有効にコミットされます。明示的コミットやロールバックはできません。

    これは DB2® for i の分離レベルです。

IBM の用語では、
  • SQL_TXN_READ_UNCOMMITTED は、非コミット読み取りです。
  • SQL_TXN_READ_COMMITTED は、カーソル固定です。
  • SQL_TXN_REPEATABLE_READ は、読み取り固定です。
  • SQL_TXN_SERIALIZABLE は、反復可能読み取りです。
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' という書式のストリング
mm
メジャー・バージョン。
vv
マイナー・バージョン。
rrrr
リリース。
例えば、'08.01.0000' は、"メジャー・バージョン 3、マイナー・バージョン 1、リリース 0" という意味です。
SQL_DROP_ASSERTION 32 ビット・マスク DROP ASSERTION ステートメント内のどの文節がデータベース管理システムにサポートされているかを示します。 Db2 ODBC は常にゼロを戻します。DROP ASSERTION ステートメントはサポートされていません。 ODBC は以下の値も定義していますが 、Db2 ODBC はこれらの値は戻しません。
  • SQL_DA_DROP_ASSERTION
SQL_DROP_CHARACTER_SET 32 ビット・マスク DROP CHARACTER SET ステートメント内のどの文節がデータベース管理システムにサポートされているかを示します。 Db2 ODBC は常にゼロを戻します。DROP CHARACTER SET ステートメントは サポートされていません。 ODBC は以下の値も定義していますが 、Db2 ODBC はこれらの値は戻しません。
  • SQL_DCS_DROP_CHARACTER_SET
SQL_DROP_COLLATION 32 ビット・マスク DROP COLLATION ステートメント内のどの文節がデータベース管理システムにサポートされているかを示します。 Db2 ODBC は常にゼロを戻します。DROP COLLATION ステートメントはサポートされていません。 ODBC は以下の値も定義していますが 、Db2 ODBC はこれらの値は戻しません。
  • SQL_DC_DROP_COLLATION
SQL_DROP_DOMAIN 32 ビット・マスク DROP DOMAIN ステートメント内のどの文節がデータベース管理システムにサポートされているかを示します。Db2 ODBC は常にゼロを戻します。DROP DOMAIN ステートメントはサポートされていません。 ODBC は以下の値も定義していますが 、Db2 ODBC はこれらの値は戻しません。
  • SQL_DD_DROP_DOMAIN
  • SQL_DD_CASCADE
  • SQL_DD_RESTRICT
SQL_DROP_SCHEMA 32 ビット・マスク DROP SCHEMA ステートメント内のどの文節がデータベース管理システムにサポートされているかを示します。
  • SQL_DS_DROP_SCHEMA
  • SQL_DS_CASCADE
  • SQL_DS_RESTRICT
SQL_DROP_TABLE 32 ビット・マスク DROP TABLE ステートメント内のどの文節がデータベース管理システムにサポートされているかを示します。
  • SQL_DT_DROP_TABLE
  • SQL_DT_CASCADE
  • SQL_DT_RESTRICT
SQL_DROP_TRANSLATION 32 ビット・マスク DROP TRANSLATION ステートメント内のどの文節がデータベース管理システムにサポートされているかを示します。Db2 ODBC は常にゼロを戻します。DROP TRANSLATION ステートメントはサポートされていません。 ODBC は以下の値も定義していますが 、Db2 ODBC はこれらの値は戻しません。
  • SQL_DTR_DROP_TRANSLATION
SQL_DROP_VIEW 32 ビット・マスク DROP VIEW ステートメント内のどの文節がデータベース管理システムにサポートされているかを示します。
  • SQL_DV_DROP_VIEW
  • SQL_DV_CASCADE
  • SQL_DV_RESTRICT
SQL_DYNAMIC_CURSOR_ATTRIBUTES1 32 ビット・マスク Db2 ODBC がサポートする動的カーソルの属性を示します (2 つのサブセットの中の 1 番目)。
  • SQL_CA1_NEXT
  • SQL_CA1_ABSOLUTE
  • SQL_CA1_RELATIVE
  • SQL_CA1_BOOKMARK
  • SQL_CA1_LOCK_EXCLUSIVE
  • SQL_CA1_LOCK_NO_CHANGE
  • SQL_CA1_LOCK_NOLOCK
  • SQL_CA1_POS_POSITION
  • SQL_CA1_POS_UPDATE
  • SQL_CA1_POS_DELETE
  • SQL_CA1_POS_REFRESH
  • SQL_CA1_POSITIONED_UPDATE
  • SQL_CA1_POSITIONED_DELETE
  • SQL_CA1_SELECT_FOR_UPDATE
  • SQL_CA1_BULK_ADD
  • SQL_CA1_BULK_UPDATE_BY_BOOKMARK
  • SQL_CA1_BULK_DELETE_BY_BOOKMARK
  • SQL_CA1_BULK_FETCH_BY_BOOKMARK
SQL_DYNAMIC_CURSOR_ATTRIBUTES2 32 ビット・マスク Db2 ODBC がサポートする動的カーソルの属性を示します (2 つのサブセットの中の 2 番目)。
  • SQL_CA2_READ_ONLY_CONCURRENCY
  • SQL_CA2_LOCK_CONCURRENCY
  • SQL_CA2_OPT_ROWVER_CONCURRENCY
  • SQL_CA2_OPT_VALUES_CONCURRENCY
  • SQL_CA2_SENSITIVITY_ADDITIONS
  • SQL_CA2_SENSITIVITY_DELETIONS
  • SQL_CA2_SENSITIVITY_UPDATES
  • SQL_CA2_MAX_ROWS_SELECT
  • SQL_CA2_MAX_ROWS_INSERT
  • SQL_CA2_MAX_ROWS_DELETE
  • SQL_CA2_MAX_ROWS_UPDATE
  • SQL_CA2_MAX_ROWS_CATALOG
  • SQL_CA2_MAX_ROWS_AFFECTS_ALL
  • SQL_CA2_CRC_EXACT
  • SQL_CA2_CRC_APPROXIMATE
  • SQL_CA2_SIMULATE_NON_UNIQUE
  • SQL_CA2_SIMULATE_TRY_UNIQUE
  • SQL_CA2_SIMULATE_UNIQUE
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_FD_FETCH_NEXT
  • SQL_FD_FETCH_FIRST
  • SQL_FD_FETCH_LAST
  • SQL_FD_FETCH_PREV
  • SQL_FD_FETCH_ABSOLUTE
  • SQL_FD_FETCH_RELATIVE
  • SQL_FD_FETCH_RESUME
SQL_FILE_USAGE 16 ビット整数 予約済み。 ゼロが戻されます。
SQL_FORWARD_ONLY_CURSOR_ATTRIBUTES1 32 ビット・マスク Db2 ODBC がサポートする前方スクロール・カーソルの属性を示します (2 つのサブセットの中の 1 番目)。
  • SQL_CA1_NEXT
  • SQL_CA1_POSITIONED_UPDATE
  • SQL_CA1_POSITIONED_DELETE
  • SQL_CA1_SELECT_FOR_UPDATE
  • SQL_CA1_LOCK_EXCLUSIVE
  • SQL_CA1_LOCK_NO_CHANGE
  • SQL_CA1_LOCK_NOLOCK
  • SQL_CA1_POS_POSITION
  • SQL_CA1_POS_UPDATE
  • SQL_CA1_POS_DELETE
  • SQL_CA1_POS_REFRESH
  • SQL_CA1_BULK_ADD
  • SQL_CA1_BULK_UPDATE_BY_BOOKMARK
  • SQL_CA1_BULK_DELETE_BY_BOOKMARK
  • SQL_CA1_BULK_FETCH_BY_BOOKMARK
SQL_FORWARD_ONLY_CURSOR_ATTRIBUTES2 32 ビット・マスク Db2 ODBC がサポートする前方スクロール・カーソルの属性を示します (2 つのサブセットの中の 2 番目)。
  • SQL_CA2_READ_ONLY_CONCURRENCY
  • SQL_CA2_LOCK_CONCURRENCY
  • SQL_CA2_MAX_ROWS_SELECT
  • SQL_CA2_MAX_ROWS_CATALOG
  • SQL_CA2_OPT_ROWVER_CONCURRENCY
  • SQL_CA2_OPT_VALUES_CONCURRENCY
  • SQL_CA2_SENSITIVITY_ADDITIONS
  • SQL_CA2_SENSITIVITY_DELETIONS
  • SQL_CA2_SENSITIVITY_UPDATES
  • SQL_CA2_MAX_ROWS_INSERT
  • SQL_CA2_MAX_ROWS_DELETE
  • SQL_CA2_MAX_ROWS_UPDATE
  • SQL_CA2_MAX_ROWS_AFFECTS_ALL
  • SQL_CA2_CRC_EXACT
  • SQL_CA2_CRC_APPROXIMATE
  • SQL_CA2_SIMULATE_NON_UNIQUE
  • SQL_CA2_SIMULATE_TRY_UNIQUE
  • SQL_CA2_SIMULATE_UNIQUE
SQL_GETDATA_EXTENSIONS 32 ビット・マスク SQLGetData() 関数の拡張がサポートされているかどうかを示します。 Db2 ODBC では、現在、以下の拡張機能が確認されており、サポートされています。
  • SQL_GD_ANY_COLUMN

    最後にバインドされた列に先行するアンバインドされた列に 対して、SQLGetData() を呼び出すことができます。

  • SQL_GD_ANY_ORDER

    列について、任意の順序で SQLGetData() を呼び出すことができます。

ODBC では、Db2 ODBC によって戻されない、以下の拡張機能も定義します。
  • SQL_GD_BLOCK
  • SQL_GD_BOUND
SQL_GROUP_BY 16 ビット整数 サーバーによる GROUP BY 文節のサポートの程度を示します。
  • SQL_GB_NO_RELATION: GROUP BY の列と SELECT リストの列の間の関係はありません。
  • SQL_GB_NOT_SUPPORTED: GROUP BY はサポートされていません。
  • SQL_GB_GROUP_BY_EQUALS_SELECT: GROUP BY には、選択リスト中の すべての非集約列が組み込まれている必要があります。
  • SQL_GB_GROUP_BY_CONTAINS_SELECT: GROUP BY 文節には、SELECT リスト中の すべての非集約列が含まれている必要があります。
SQL_IDENTIFIER_CASE 16 ビット整数 オブジェクト名 (例えば、表名) の大/小文字の区別を示します。
値は、以下のとおりです。
  • SQL_IC_UPPER = ID 名は大文字でシステム・カタログに保管されます。
  • SQL_IC_LOWER = ID 名は小文字でシステム・カタログに保管されます。
  • SQL_IC_SENSITIVE = ID 名は大/小文字の区別があり、大/小文字 を混合してシステム・カタログに保管されます。
  • SQL_IC_MIXED = ID 名は大/小文字の区別がなく、大/小文字を混合 してシステム・カタログに保管されます。

IBM 固有: IBM データベース管理システムの ID 名は大/小文字の区別がありません。

SQL_IDENTIFIER_QUOTE_CHAR ストリング (string) 区切り ID を囲むために使用される文字を示します。
SQL_INFO_SCHEMA_VIEWS 32 ビット・マスク サポートされる INFORMATIONAL_SCHEMA 内のビューを示します。 Db2 ODBC は常にゼロを戻します。INFORMATIONAL_SCHEMA 内のビューはサポートされません。ODBC は以下の値も定義していますが 、Db2 ODBC はこれらの値は戻しません。
  • SQL_ISV_ASSERTIONS
  • SQL_ISV_CHARACTER_SETS
  • SQL_ISV_CHECK_CONSTRAINTS
  • SQL_ISV_COLLATIONS
  • SQL_ISV_COLUMN_DOMAIN_USAGE
  • SQL_ISV_COLUMN_PRIVILEGES
  • SQL_ISV_COLUMNS
  • SQL_ISV_CONSTRAINT_COLUMN_USAGE
  • SQL_ISV_CONSTRAINT_TABLE_USAGE
  • SQL_ISV_DOMAIN_CONSTRAINTS
  • SQL_ISV_DOMAINS
  • SQL_ISV_KEY_COLUMN_USAGE
  • SQL_ISV_REFERENTIAL_CONSTRAINTS
  • SQL_ISV_SCHEMATA
  • SQL_ISV_SQL_LANGUAGES
  • SQL_ISV_TABLE_CONSTRAINTS
  • SQL_ISV_TABLE_PRIVILEGES
  • SQL_ISV_TABLES
  • SQL_ISV_TRANSLATIONS
  • SQL_ISV_USAGE_PRIVILEGES
  • SQL_ISV_VIEW_COLUMN_USAGE
  • SQL_ISV_VIEW_TABLE_USAGE
  • SQL_ISV_VIEWS
SQL_INSERT_STATEMENT 32 ビット・マスク INSERT ステートメントのサポートを示します。
  • SQL_IS_INSERT_LITERALS
  • SQL_IS_INSERT_SEARCHED
  • SQL_IS_SELECT_INTO
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_CA1_NEXT
  • SQL_CA1_ABSOLUTE
  • SQL_CA1_RELATIVE
  • SQL_CA1_BOOKMARK
  • SQL_CA1_LOCK_EXCLUSIVE
  • SQL_CA1_LOCK_NO_CHANGE
  • SQL_CA1_LOCK_NOLOCK
  • SQL_CA1_POS_POSITION
  • SQL_CA1_POS_UPDATE
  • SQL_CA1_POS_DELETE
  • SQL_CA1_POS_REFRESH
  • SQL_CA1_POSITIONED_UPDATE
  • SQL_CA1_POSITIONED_DELETE
  • SQL_CA1_SELECT_FOR_UPDATE
  • SQL_CA1_BULK_ADD
  • SQL_CA1_BULK_UPDATE_BY_BOOKMARK
  • SQL_CA1_BULK_DELETE_BY_BOOKMARK
  • SQL_CA1_BULK_FETCH_BY_BOOKMARK
SQL_KEYSET_CURSOR_ATTRIBUTES2 32 ビット・マスク Db2 ODBC がサポートするキーセット・カーソルの属性を示します (2 つのサブセットの中の 2 番目)。
  • SQL_CA2_READ_ONLY_CONCURRENCY
  • SQL_CA2_LOCK_CONCURRENCY
  • SQL_CA2_OPT_ROWVER_CONCURRENCY
  • SQL_CA2_OPT_VALUES_CONCURRENCY
  • SQL_CA2_SENSITIVITY_ADDITIONS
  • SQL_CA2_SENSITIVITY_DELETIONS
  • SQL_CA2_SENSITIVITY_UPDATES
  • SQL_CA2_MAX_ROWS_SELECT
  • SQL_CA2_MAX_ROWS_INSERT
  • SQL_CA2_MAX_ROWS_DELETE
  • SQL_CA2_MAX_ROWS_UPDATE
  • SQL_CA2_MAX_ROWS_CATALOG
  • SQL_CA2_MAX_ROWS_AFFECTS_ALL
  • SQL_CA2_CRC_EXACT
  • SQL_CA2_CRC_APPROXIMATE
  • SQL_CA2_SIMULATE_NON_UNIQUE
  • SQL_CA2_SIMULATE_TRY_UNIQUE
  • SQL_CA2_SIMULATE_UNIQUE
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_NNC_NON_NULL: 列を NOT NULL として定義できません。
  • SQL_NNC_NULL: 列を NOT NULL として定義できます。
SQL_NULL_COLLATION 16 ビット整数 リスト中で NULL 値がソートされる場所を示します。
  • SQL_NC_HIGH: NULL 値が高位にソートされます。
  • SQL_NC_LOW: NULL 値が低位にソートされることを示します。
SQL_NUMERIC_FUNCTIONS 32 ビット・マスク ODBC スカラー数字関数がサポートされることを示します。 これらの関数は ODBC ベンダー・エスケープ・シーケンスとともに使用することを目的としています。
以下のビット・マスクを使用して、サポートされている数字関数を判別します。
  • SQL_FN_NUM_ABS
  • SQL_FN_NUM_ACOS
  • SQL_FN_NUM_ASIN
  • SQL_FN_NUM_ATAN
  • SQL_FN_NUM_ATAN2
  • SQL_FN_NUM_CEILING
  • SQL_FN_NUM_COS
  • SQL_FN_NUM_COT
  • SQL_FN_NUM_DEGREES
  • SQL_FN_NUM_EXP
  • SQL_FN_NUM_FLOOR
  • SQL_FN_NUM_LOG
  • SQL_FN_NUM_LOG10
  • SQL_FN_NUM_MOD
  • SQL_FN_NUM_PI
  • SQL_FN_NUM_POWER
  • SQL_FN_NUM_RADIANS
  • SQL_FN_NUM_RAND
  • SQL_FN_NUM_ROUND
  • SQL_FN_NUM_SIGN
  • SQL_FN_NUM_SIN
  • SQL_FN_NUM_SQRT
  • SQL_FN_NUM_TAN
  • SQL_FN_NUM_TRUNCATE
SQL_ODBC_API_CONFORMANCE 16 ビット整数 ODBC 適合性のレベル。
  • SQL_OAC_NONE
  • SQL_OAC_LEVEL1
  • SQL_OAC_LEVEL2
SQL_ODBC_SAG_CLI_CONFORMANCE 16 ビット整数 SQL アクセス・グループ (SAG) CLI 仕様の関数への適合性。
値は、以下のとおりです。
  • SQL_OSCC_NOT_COMPLIANT : ドライバーは SAG に適合しません。
  • SQL_OSCC_COMPLIANT : ドライバーは SAG に適合します。
SQL_ODBC_SQL_CONFORMANCE 16 ビット整数 値は、以下のとおりです。
  • SQL_OSC_MINIMUM - 現行のデータベース管理システムは、最小 ODBC SQL 文法をサポートしていることを意味します。 最小 SQL 文法は、以下のエレメントを含んでいる必要があります。
    • CREATE TABLE および DROP TABLE のデータ定義
    • 単純な SELECT、INSERT、UPDATE、および DELETE のデータ操作
    • 単純式
    • CHAR、VARCHAR、および LONG VARCHAR データ・タイプ
  • SQL_OSC_CORE - 現行のデータベース管理システムは、コア ODBC SQL 文法をサポートしていることを意味します。 コア ODBC SQL 文法は、以下のエレメントを含んでいる必要があります。
    • 最小 ODBC SQL 文法
    • ALTER TABLE、CREATE INDEX、DROP INDEX、 CREATE VIEW、DROP VIEW、GRANT、および REVOKE のデータ定義
    • 完全な SELECT データ操作
    • 副照会および関数式
    • DECIMAL、NUMERIC、SMALLINT、INTEGER、 REAL、FLOAT、DOUBLE PRECISION のデータ・タイプ
  • SQL_OSC_EXTENDED - 現行のデータベース管理システムは、拡張 ODBC SQL 文法をサポートしていることを意味します。 拡張 ODBC SQL 文法は、以下のエレメントを含んでいる必要があります。
    • コア ODBC SQL 文法
    • 位置付け UPDATE、位置付け DELETE、SELECT FOR UPDATE、および UNION のデータ定義
    • スカラー関数、リテラル日付、リテラル時間、およびリテラル・タイム・スタンプの式
    • BIT、TINYINT、BIGINT、BINARY、VARBINARY、 LONG VARBINARY、DATE、TIME、TIMESTAMP、および XML のデータ・タイプ
    • バッチ SQL ステートメント
    • プロシージャー呼び出し
SQL_ODBC_VER ストリング (string) ドライバー・マネージャーがサポートする ODBC のバージョン番号。

Db2 ODBC はストリング「03.01.0000」を戻します。

SQL_OJ_CAPABILITIES 32 ビット・マスク サポートされている外部結合タイプを 列挙する 32 ビット・マスク。
ビット・マスクは以下のとおりです。
  • SQL_OJ_LEFT : 左外部結合がサポートされています。
  • SQL_OJ_RIGHT : 右外部結合がサポートされています。
  • SQL_OJ_FULL : 全外部結合がサポートされています。
  • SQL_OJ_NESTED : ネスト外部結合がサポートされています。
  • SQL_OJ_NOT_ORDERED : 外部結合 ON 文節の列の基礎となる 表の順序は、JOIN 文節の表の順序と同じである必要はありません。
  • SQL_OJ_INNER : 外部結合の内部表を内部結合にすることもできます。
  • SQL_OJ_ALL_COMPARISONS_OPS : 外部結合 ON 文節内で任意の述部を 使用できます。 このビットが設定されていない場合は、ON 文節中で有効な 比較演算子は等価演算子 (=) のみです。
SQL_ORDER_BY_COLUMNS_IN_SELECT ストリング (string) ORDER BY 文節の列を選択リストに入れる 必要がある場合は 'Y' に設定し、必要ない場合は 'N' に設定します。
SQL_OUTER_JOINS ストリング (string) 以下の文字ストリング。
  • 'Y' は、外部結合がサポートされており、さらに Db2 ODBC が ODBC 外部結合要求構文 をサポートしていることを示します。
  • 'N' は、外部結合がサポートされていないことを示します。
SQL_OWNER_TERM (Db2 ODBC の前のバージョンでは、InfoType は SQL_SCHEMA_TERM です。) ストリング (string) データベース・ベンダーの (所有者の) スキーマの用語
SQL_PARAM_ARRAY_ROW_COUNTS 32 ビットの符号なし整数 パラメーターを使用する実行において、どのような行数が使用できるかを示します。
  • SQL_PARC_BATCH: それぞれのパラメーターのセットに、個々の行数が使用できます。 このことは、ドライバーにとって概念的には、 配列内のそれぞれのパラメーター・セットごとに 1 つずつ 、SQL ステートメントのバッチを生成することに相当します。SQL_PARAM_STATUS_PTR 記述子フィールドを使用して、 拡張エラー情報を取り出すことができます。
  • SQL_PARC_NO_BATCH: 1 つの行数だけが使用可能であり、これは、 パラメーター配列全体について、ステートメントを実行して得られた累積の行数です。 これは、概念的には、パラメーター配列全体を 1 つのアトミック単位として ステートメントを扱うことに相当します。 エラーは、1 つのステートメントが実行されたかのように取り扱われます。
SQL_PARAM_ARRAY_SELECTS 32 ビットの符号なし整数 パラメーターを使用する実行において、 どのような結果セットが使用できるかを示します。
  • SQL_PAS_BATCH: パラメーターのセットごとに、1 つの結果セットが使用できます。 このことは、ドライバーにとって概念的には、 配列内のそれぞれのパラメーター・セットごとに 1 つずつ 、SQL ステートメントのバッチを生成することに相当します。
  • SQL_PAS_NO_BATCH: 1 つの結果セットだけが使用可能であり、これは、 パラメーター配列全体について、ステートメントを実行して得られた 累積の結果セットです。 これは、概念的には、パラメーター配列全体を 1 つのアトミック単位として ステートメントを扱うことに相当します。
  • SQL_PAS_NO_SELECT: ドライバーは、パラメーター配列を使用して 結果セット生成ステートメントを実行することを許可しません。
SQL_POS_OPERATIONS 32 ビット・マスク 予約済み属性。ビット・マスクにはゼロが戻されます。
SQL_POSITIONED_STATEMENTS 32 ビット・マスク 位置付け UPDATE および位置付け DELETE ステートメント がサポートされている程度を示します。
  • SQL_PS_POSITIONED_DELETE
  • SQL_PS_POSITIONED_UPDATE
  • SQL_PS_SELECT_FOR_UPDATE: カーソルを使って列を更新するために、 サーバーで FOR UPDATE 文節を <照会式> に指定する必要があるかどうかを示します。
SQL_PROCEDURE_TERM ストリング (string) データベース・ベンダーがプロシージャー用に使用している名前。
SQL_PROCEDURES ストリング (string) 「Y」は、データ・ソースがプロシージャーをサポートしており、Db2 ODBC が ODBC プロシージャー呼び出し構文をサポートしていることを示します。「N」は、サポートしていないことを示します。
SQL_QUOTED_IDENTIFIER_CASE 16 ビット整数 以下を戻します。
  • SQL_IC_UPPER : SQL 中の引用符付き ID は大/小文字を区別しないで、 大文字でシステム・カタログに保管されます。
  • SQL_IC_LOWER : SQL 中の引用符付き ID は大/小文字を区別しないで、 小文字でシステム・カタログに保管されます。
  • SQL_IC_SENSITIVE : SQL 中の引用符付き ID (区切り ID) は 大/小文字の区別があり、大/小文字の混合でシステム・カタログに 保管されます。
  • SQL_IC_MIXED : SQL 中の引用符付き ID は大/小文字を区別しないで、 大/小文字の混合でシステム・カタログに保管されます。
これは、(引用符のない) ID をシステム・カタログに保管する方法を決めるのに 使用する SQL_IDENTIFIER_CASE InfoType とは対照的です。
SQL_ROW_UPDATES ストリング (string) 文字ストリング「Y」は、同じ行を複数回フェッチする間に、行の変更が検出されることを示します。「N」は、変更が検出されないことを示します。
SQL_SCHEMA_USAGE (Db2 ODBC の前のバージョンでは、InfoType は SQL_OWNER_USAGE です。) 32 ビット・マスク SQL ステートメントの実行時に、 関連したスキーマ (所有者) のあるステートメントのタイプを示します。 スキーマ修飾子 (所有者) のサポートは、以下のとおりです。
  • SQL_OU_DML_STATEMENTS : すべてのデータ操作言語ステートメントでサポートされています。
  • SQL_OU_PROCEDURE_INVOCATION : プロシージャー呼び出しステートメント でサポートされています。
  • SQL_OU_TABLE_DEFINITION : すべての表定義ステートメントで サポートされています。
  • SQL_OU_INDEX_DEFINITION : すべての索引定義ステートメントでサポートされています。
  • SQL_OU_PRIVILEGE_DEFINITION : すべての特権定義ステートメント (例えば、 付与ステートメントと取り消しステートメント) でサポートされています。
SQL_SCROLL_CONCURRENCY 32 ビット・マスク カーソル用にサポートされている並行性のオプションを示します。
以下のビット・マスクをフラグと一緒に使用して、サポートされている属性値を判別します。
  • SQL_SCCO_READ_ONLY
  • SQL_SCCO_LOCK
  • SQL_SCCO_OPT_TIMESTAMP
  • SQL_SCCO_OPT_VALUES

Db2 ODBC は、SQL_SCCO_LOCK を戻します。これは、使用されるロッキングのレベルに、行を確実に更新するのに十分な、最低レベルのロッキングを使用することを示しています。

SQL_SCROLL_OPTIONS 32 ビット・マスク 両方向スクロール・カーソルをサポートするスクロール・オプションです。
以下のビット・マスクをフラグと一緒に使用して、サポートされている属性値を判別します。
  • SQL_SO_FORWARD_ONLY
  • SQL_SO_KEYSET_DRIVEN
  • SQL_SO_STATIC
  • SQL_SO_DYNAMIC
  • SQL_SO_MIXED
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_SP_BETWEEN
  • SQL_SP_COMPARISON
  • SQL_SP_EXISTS
  • SQL_SP_IN
  • SQL_SP_ISNOTNULL
  • SQL_SP_ISNULL
  • SQL_SP_LIKE
  • SQL_SP_MATCH_FULL
  • SQL_SP_MATCH_PARTIAL
  • SQL_SP_MATCH_UNIQUE_FULL
  • SQL_SP_MATCH_UNIQUE_PARTIAL
  • SQL_SP_OVERLAPS
  • SQL_SP_QUANTIFIED_COMPARISON
  • SQL_SP_UNIQUE
SQL_SQL92_VALUE_EXPRESSIONS 32 ビット・マスク SQL92 により定義され、サポートされる以下の値式を示します。
  • SQL_SVE_CASE
  • SQL_SVE_CAST
  • SQL_SVE_COALESCE
  • SQL_SVE_NULLIF
SQL_STATIC_CURSOR_ATTRIBUTES1 32 ビット・マスク Db2 ODBC がサポートする静的カーソルの属性を示します (2 つのサブセットの中の 1 番目)。
  • SQL_CA1_NEXT
  • SQL_CA1_ABSOLUTE
  • SQL_CA1_RELATIVE
  • SQL_CA1_BOOKMARK
  • SQL_CA1_LOCK_EXCLUSIVE
  • SQL_CA1_LOCK_NO_CHANGE
  • SQL_CA1_LOCK_NOLOCK
  • SQL_CA1_POS_POSITION
  • SQL_CA1_POS_UPDATE
  • SQL_CA1_POS_DELETE
  • SQL_CA1_POS_REFRESH
  • SQL_CA1_POSITIONED_UPDATE
  • SQL_CA1_POSITIONED_DELETE
  • SQL_CA1_SELECT_FOR_UPDATE
  • SQL_CA1_BULK_ADD
  • SQL_CA1_BULK_UPDATE_BY_BOOKMARK
  • SQL_CA1_BULK_DELETE_BY_BOOKMARK
  • SQL_CA1_BULK_FETCH_BY_BOOKMARK
SQL_STATIC_CURSOR_ATTRIBUTES2 32 ビット・マスク Db2 ODBC がサポートする静的カーソルの属性を示します (2 つのサブセットの中の 2 番目)。
  • SQL_CA2_READ_ONLY_CONCURRENCY
  • SQL_CA2_LOCK_CONCURRENCY
  • SQL_CA2_OPT_ROWVER_CONCURRENCY
  • SQL_CA2_OPT_VALUES_CONCURRENCY
  • SQL_CA2_SENSITIVITY_ADDITIONS
  • SQL_CA2_SENSITIVITY_DELETIONS
  • SQL_CA2_SENSITIVITY_UPDATES
  • SQL_CA2_MAX_ROWS_SELECT
  • SQL_CA2_MAX_ROWS_INSERT
  • SQL_CA2_MAX_ROWS_DELETE
  • SQL_CA2_MAX_ROWS_UPDATE
  • SQL_CA2_MAX_ROWS_CATALOG
  • SQL_CA2_MAX_ROWS_AFFECTS_ALL
  • SQL_CA2_CRC_EXACT
  • SQL_CA2_CRC_APPROXIMATE
  • SQL_CA2_SIMULATE_NON_UNIQUE
  • SQL_CA2_SIMULATE_TRY_UNIQUE
  • SQL_CA2_SIMULATE_UNIQUE
SQL_STATIC_SENSITIVITY 32 ビット・マスク アプリケーションが位置付け UPDATE または位置付け DELETE ステートメント を使用して行った変更を、そのアプリケーションが検出できるかどうかを示します。
  • SQL_SS_ADDITIONS: カーソルは追加された行を認識できます。 カーソルは追加された行へスクロールできます。 すべての Db2 サーバーは追加された行を認識できます。
  • SQL_SS_DELETIONS: 削除された行では、カーソルは使用できなくなりますが、結果セットに 穴が残ることはありません。 カーソルは、削除された行からスクロールした後、その行に戻ることはできません。
  • SQL_SS_UPDATES: カーソルは行への更新を認識できます。カーソルが、更新された行から スクロールした後その行に戻ると、そのカーソルによって戻されるデータは、更新済みデータであり、 元のデータではありません。
SQL_STRING_FUNCTIONS 32 ビット・マスク サポートされるストリング関数を示します。
以下のビット・マスクを使用して、サポートされているストリング関数を判別します。
  • SQL_FN_STR_ASCII
  • SQL_FN_STR_CHAR
  • SQL_FN_STR_CONCAT
  • SQL_FN_STR_DIFFERENCE
  • SQL_FN_STR_INSERT
  • SQL_FN_STR_LCASE
  • SQL_FN_STR_LEFT
  • SQL_FN_STR_LENGTH
  • SQL_FN_STR_LOCATE
  • SQL_FN_STR_LOCATE_2
  • SQL_FN_STR_LTRIM
  • SQL_FN_STR_REPEAT
  • SQL_FN_STR_REPLACE
  • SQL_FN_STR_RIGHT
  • SQL_FN_STR_RTRIM
  • SQL_FN_STR_SOUNDEX
  • SQL_FN_STR_SPACE
  • SQL_FN_STR_SUBSTRING
  • SQL_FN_STR_UCASE

アプリケーションが、引数 string1、string2、および start を 用いて LOCATE スカラー関数を呼び出せる場合は、SQL_FN_STR_LOCATE ビット・マスクが戻されます。 アプリケーションが、string1 および string2 を用いた LOCATE スカラー関数しか 呼び出せない場合は、SQL_FN_STR_LOCATE_2 ビット・マスクが戻されます。 LOCATE スカラー関数が完全にサポートされている場合は、両方のビット・マスクが戻されます。

SQL_SUBQUERIES 32 ビット・マスク 副照会をサポートしている述部を示します。
  • SQL_SQ_COMPARISON : comparison 述部
  • SQL_SQ_CORRELATE_SUBQUERIES : すべての述部
  • SQL_SQ_EXISTS : exists 述部
  • SQL_SQ_IN : in 述部
  • SQL_SQ_QUANTIFIED : 多値比較スカラー関数を含む述部
SQL_SYSTEM_FUNCTIONS 32 ビット・マスク サポートされるスカラー・システム関数を示します。
以下のビット・マスクを使用して、サポートされているスカラー・システム関数を判別します。
  • SQL_FN_SYS_DBNAME
  • SQL_FN_SYS_IFNULL
  • SQL_FN_SYS_USERNAME

ヒント: これらの関数は、ODBC のエスケープ・シーケンスとともに 使用するためのものです。

SQL_TABLE_TERM ストリング (string) データベース・ベンダーの表用の用語。
SQL_TIMEDATE_ADD_INTERVALS 32 ビット・マスク 特殊な ODBC システム関数 TIMESTAMPADD がサポートされている かどうか、サポートされている場合はサポートされている時間間隔を示します。
以下のビット・マスクを使用して、サポートされている時間間隔を判別します。
  • SQL_FN_TSI_FRAC_SECOND
  • SQL_FN_TSI_SECOND
  • SQL_FN_TSI_MINUTE
  • SQL_FN_TSI_HOUR
  • SQL_FN_TSI_DAY
  • SQL_FN_TSI_WEEK
  • SQL_FN_TSI_MONTH
  • SQL_FN_TSI_QUARTER
  • SQL_FN_TSI_YEAR
SQL_TIMEDATE_DIFF_INTERVALS 32 ビット・マスク 特殊な ODBC システム関数 TIMESTAMPDIFF がサポートされている かどうか、サポートされている場合はサポートされている時間間隔を示します。
以下のビット・マスクを使用して、サポートされている時間間隔を判別します。
  • SQL_FN_TSI_FRAC_SECOND
  • SQL_FN_TSI_SECOND
  • SQL_FN_TSI_MINUTE
  • SQL_FN_TSI_HOUR
  • SQL_FN_TSI_DAY
  • SQL_FN_TSI_WEEK
  • SQL_FN_TSI_MONTH
  • SQL_FN_TSI_QUARTER
  • SQL_FN_TSI_YEAR
SQL_TIMEDATE_FUNCTIONS 32 ビット・マスク サポートされる日付と時間の関数を示します。
以下のビット・マスクを使用して、サポートされている日付関数を判別します。
  • SQL_FN_TD_CURDATE
  • SQL_FN_TD_CURTIME
  • SQL_FN_TD_DAYNAME
  • SQL_FN_TD_DAYOFMONTH
  • SQL_FN_TD_DAYOFWEEK
  • SQL_FN_TD_DAYOFYEAR
  • SQL_FN_TD_HOUR
  • SQL_FN_TD_JULIAN_DAY
  • SQL_FN_TD_MINUTE
  • SQL_FN_TD_MONTH
  • SQL_FN_TD_MONTHNAME
  • SQL_FN_TD_NOW
  • SQL_FN_TD_QUARTER
  • SQL_FN_TD_SECOND
  • SQL_FN_TD_SECONDS_SINCE_MIDNIGHT
  • SQL_FN_TD_TIMESTAMPADD
  • SQL_FN_TD_TIMESTAMPDIFF
  • SQL_FN_TD_WEEK
  • SQL_FN_TD_YEAR

ヒント: これらの関数は、ODBC のエスケープ・シーケンスとともに 使用するためのものです。

SQL_TXN_CAPABLE 16 ビット整数 トランザクションが、データ定義言語またはデータ操作言語、あるいはその両方を含むことができるかどうかを示します。
  • SQL_TC_NONE - トランザクションはサポートされていません。
  • SQL_TC_DML - トランザクションは、データ操作言語ステートメント (SELECT、INSERT、UPDATE、DELETE など) のみを含むことができます。トランザクションにデータ定義言語ステートメント (CREATE TABLE、DROP INDEX など) があると、エラーになります。
  • SQL_TC_DDL_COMMIT - トランザクションは、データ操作言語ステートメントのみを含むことができます。トランザクションにデータ定義言語ステートメントがあると、そのトランザクションはコミットされます。
  • SQL_TC_DDL_IGNORE - トランザクションは、データ操作言語ステートメントのみを含むことができます。トランザクションにデータ定義言語ステートメントがあると、そのステートメントは無視されます。
  • SQL_TC_ALL - トランザクションは、データ定義言語ステートメントとデータ操作言語ステートメントを任意の順序で含むことができます。
SQL_TXN_ISOLATION_OPTION 32 ビット・マスク 現在接続中のデータベース・サーバーで使用できるトランザクション分離レベル。
以下のビット・マスクをフラグと一緒に使用して、サポートされている属性値を判別します。
  • SQL_TXN_READ_UNCOMMITTED
  • SQL_TXN_READ_COMMITTED
  • SQL_TXN_REPEATABLE_READ
  • SQL_TXN_SERIALIZABLE
  • SQL_TXN_NOCOMMIT
  • SQL_TXN_VERSIONING
個々のレベルに関する説明は、SQL_DEFAULT_TXN_ISOLATION を参照してください。
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_U_UNION : UNION 文節をサポートしています。
  • SQL_U_UNION_ALL : UNION 文節の ALL キーワードをサポートしています。
SQL_U_UNION_ALL が設定されている場合は、SQL_U_UNION も同様に設定されています。
SQL_USER_NAME ストリング (string) 特定のデータベースで使用されるユーザー名。 これは SQLConnect() 呼び出しで指定される ID です。
SQL_XOPEN_CLI_YEAR ストリング (string) ドライバーのバージョンが完全に準拠する X/Open 仕様の公表の年を示します。

戻りコード

SQLGetInfo() は、呼び出された後、次のいずれかの値を戻します。
  • SQL_SUCCESS
  • SQL_SUCCESS_WITH_INFO
  • SQL_ERROR
  • SQL_INVALID_HANDLE

診断

次の表は、この関数が生成する各 SQLSTATE 値ごとに、 その記述と説明を一覧で記載してあります。

表 4. SQLGetInfo() の 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 でもデータ・ソースでもサポートされていません。

例

次のコード行は、SQLGetInfo() を使用して現行のデータ・ソース名を取り出します。
SQLCHAR         buffer[255];
SQLSMALLINT     outlen;
rc = SQLGetInfo(hdbc, SQL_DATA_SOURCE_NAME, buffer, 255, &outlen);
printf("¥nServer Name: %s¥n", buffer);