C データ・タイプと SQL データ・タイプ

Db2® ODBC は、一連の SQL シンボリック・データ・タイプを定義します。各 SQL シンボリック・データ・タイプには、対応するデフォルトの C データ・タイプがあります。

以下のデータ・タイプは、ODBC 3.0 の最小、コア、および拡張の データ・タイプの組み合わせを表しています。Db2 ODBC は、以下の追加のデータ・タイプをサポートしています。
  • SQL_GRAPHIC
  • SQL_VARGRAPHIC
  • SQL_LONGVARGRAPHIC
表 1 では、それぞれの SQL データ・タイプ、 それに対応するシンボル名、およびデフォルトの C シンボル名をリストしています。 この表には、以下の欄があります。
SQL データ・タイプ
この欄には、SQL CREATE DDL ステートメントに現れる SQL データ・タイプを示して います。SQL データ・タイプはデータベース・サーバーに依存しています。
シンボリック SQL データ・タイプ
この欄は、整数値として (sqlcli1.h で) 定義される SQL シンボル名を示しています。 この値は、最初の欄にリストした SQL データ・タイプを示しており、さまざまな関数で使用されます。
デフォルトの C シンボリック・データ・タイプ
この欄には C シンボル名が含まれ、これも整数値として定義されています。 これらの値は、表 2 に示す C データ・タイプを示しており、 さまざまな関数の引数で使用されます。 シンボル名は、アプリケーション変数の C データ・タイプを示すために、 さまざまな関数 (SQLBindParameter()、SQLGetData()、および SQLBindCol() 呼び出しなど) で 使用されます。これらの関数を呼び出す際に C データ・タイプを明示的に示す代わりに、SQL_C_DEFAULT を 指定することができ、Db2 ODBC は、この表で示されているパラメーターまたは欄 の SQL データ・タイプに基づいて、デフォルトの C データ・タイプを想定します。例えば、SQL_DECIMAL のデフォルト C データ・タイプは SQL_C_CHAR です。
表 1. SQL シンボリック・データ・タイプおよびデフォルトのデータ・タイプ
SQL データ・タイプ シンボリック SQL データ・タイプ デフォルトの C シンボリック・データ・タイプ
BIGINT SQL_BIGINT SQL_C_BIGINT
BINARY SQL_BINARY SQL_C_BINARY
BLOB SQL_BLOB SQL_C_BINARY
BLOB LOCATOR1 SQL_BLOB_LOCATOR SQL_C_BLOB_LOCATOR
CHAR SQL_CHAR SQL_C_CHAR
CHAR FOR BIT DATA 6 SQL_BINARY SQL_C_BINARY
CLOB SQL_CLOB SQL_C_CHAR
CLOB LOCATOR SQL_CLOB_LOCATOR SQL_C_CLOB_LOCATOR
DATE SQL_TYPE_DATE2 SQL_C_TYPE_DATE
DBCLOB SQL_DBCLOB SQL_C_DBCHAR
DBCLOB LOCATOR1 SQL_DBCLOB_LOCATOR SQL_C_DBCLOB_LOCATOR
DECFLOAT(16) または DECFLOAT(34) SQL_DECFLOAT SQL_C_CHAR
DECIMAL SQL_DECIMAL SQL_C_CHAR
DOUBLE SQL_DOUBLE SQL_C_DOUBLE
FLOAT SQL_FLOAT SQL_C_DOUBLE
GRAPHIC SQL_GRAPHIC SQL_C_DBCHAR または SQL_C_WCHAR4
INTEGER SQL_INTEGER SQL_C_LONG
LONG VARCHAR5 SQL_LONGVARCHAR SQL_C_CHAR
LONG VARCHAR FOR BIT DATA5,6 SQL_LONGVARBINARY SQL_C_BINARY
LONG VARGRAPHIC5 SQL_LONGVARGRAPHIC SQL_C_DBCHAR または SQL_C_WCHAR4
NUMERIC7 SQL_NUMERIC7 SQL_C_CHAR
REAL SQL_REAL SQL_C_FLOAT
ROWID SQL_ROWID SQL_C_CHAR
SMALLINT SQL_SMALLINT SQL_C_SHORT
TIME SQL_TYPE_TIME2 SQL_C_TYPE_TIME
TIMESTAMP SQL_TYPE_TIMESTAMP2
SQL_C_TYPE_TIMESTAMP
SQL_C_TYPE_TIMESTAMP_EXT3
VARBINARY SQL_VARBINARY SQL_C_BINARY
VARCHAR SQL_VARCHAR SQL_C_CHAR
VARCHAR FOR BIT DATA6 SQL_VARBINARY SQL_C_BINARY
VARGRAPHIC SQL_VARGRAPHIC SQL_C_DBCHAR または SQL_C_WCHAR4
XML SQL_XML SQL_C_BINARY
注:
  1. LOB ロケーター・タイプは持続 SQL データ・タイプではありません (列は、ロケーター・タイプ では定義できません。その代わりに、ロケーター・タイプは、パラメーター・マーカーを記述するか、 または LOB 値を表します)。
  2. 日時データ・タイプの変更は、以前のリリースから成されています。
  3. SQL_C_TYPE_TIMESTAMP_EXT は、小数点以下の精度が 0 桁から 12 桁の TIMESTAMP 値で使用されます。
  4. この SQL データ・タイプのデフォルトの C データ・タイプ変換は、アプリケーションが 使用するコード化スキームに依存しています。 アプリケーションが UCS-2 ユニコード・エンコード方式を使用している場合は、デフォルト は SQL_C_WCHAR への変換です。 その他すべてのコード化スキームの場合は、デフォルトは SQL_C_DBCHAR への変換です。
  5. 可能であれば LONG データ・タイプを LOB タイプに置き換えてください。
  6. 可能であれば、常に、FOR BIT DATA データ・タイプを BINARY または VARBINARY タイプに置き換えてください。
  7. Db2 for z/OS®、DB2® for VSE & VM、および Db2 for Linux, UNIX, and Windows では、NUMERIC は DECIMAL の同義語です。

追加情報:

  • データ・タイプ DATE、DECIMAL、NUMERIC、TIME、および TIMESTAMP は、 変換せずにデフォルトの C バッファー・タイプに転送することはできません。
表 2 では、それぞれの C シンボリック・タイプごとに、総称 C タイプの 定義を示しています。 この表には、以下の欄があります。
C シンボリック・データ・タイプ
この欄では、整数値として定義された C シンボル名を示しています。これらの値は、最後の欄に示された C データ・タイプを示すために、 さまざまな関数の引数で使用されます。
C タイプ
この欄は C で定義されたタイプを示しています。 これは、C typedef ステートメントを使用して sqlcli1.h で定義されます。 アプリケーションの移植性を高めるために、この欄の値を使用して、 すべての Db2 ODBC 関連の変数および引数を宣言してください。
基本 C タイプ
この欄は参照目的用にのみ、示してあります。 すべての変数および引数は、これより前の欄にあるシンボリック・タイプ を使用して定義してください。一部の値は 表 3 で説明されている C 構造です。
表 2. C データ・タイプ
C シンボリック・データ・タイプ C タイプ 基本 C タイプ
SQL_C_BIGINT SQLBIGINT long long int
SQL_C_CHAR SQLCHAR Unsigned char
SQL_C_BIT SQLCHAR Unsigned char または char (値 1 または 0)
SQL_C_TINYINT SQLSCHAR Signed char (-128 から 127 の範囲)
SQL_C_SHORT SQLSMALLINT Short int
SQL_C_LONG SQLINTEGER Long int (31 ビット) または int (64 ビット)1
SQL_C_DOUBLE SQLDOUBLE Double
SQL_C_FLOAT SQLREAL Float
SQL_C_DECIMAL64 SQLDECIMAL64 表 3 を参照してください
SQL_C_DECIMAL128 SQLDECIMAL128 表 3 を参照してください
SQL_C_TYPE_DATE2 DATE_STRUCT 表 3 を参照してください
SQL_C_TYPE_TIMESTAMP2 TIMESTAMP_STRUCT 表 3 を参照してください
SQL_C_TYPE_TIMESTAMP_EXT 2 TIMESTAMP_STRUCT_EXT 表 3 を参照してください
SQL_C_CLOB_LOCATOR SQLINTEGER Long int (31 ビット) または int (64 ビット)1
SQL_C_BINARY SQLCHAR Unsigned char
SQL_C_BINARYXML SQLCHAR Unsigned char
SQL_C_BLOB_LOCATOR SQLINTEGER Long int (31 ビット) または int (64 ビット)1
SQL_C_DBCHAR SQLDBCHAR Unsigned short
SQL_C_DBCLOB_LOCATOR SQLINTEGER Long int (31 ビット) または int (64 ビット)1
SQL_C_WCHAR SQLWCHAR wchar_t (31 ビット) または符号なし short (64 ビット)1
注:
  1. 31 ビットは 31 ビット・アプリケーション用、64 ビットは 64 ビット・アプリケーション用です。

    31 ビット環境では、long int は 32 ビットです。64 ビット環境では、int も 32 ビットです。したがって、C タイプ SQLINTEGER は、環境に関係なく 32 ビット・フィールドにマップされます。

    31 ビット環境では、wchar_t は 16 ビットです。64 ビット環境では、符号なし short も 16 ビットです。したがって、C タイプ SQLWCHAR は、環境に関係なく 16 ビット・フィールドにマップされます。

  2. 日時データ・タイプの変更は、以前のリリースから成されています。

次の表は、日付、時刻、タイム・スタンプ、および 10 進浮動小数点の C データ・タイプとそれに関連する構造をリストしています。

表 3. C の日付、時刻、タイム・スタンプ、および 10 進浮動小数点の構造
C タイプ 一般構造
DATE_STRUCT
typedef struct DATE_STRUCT
  {
    SQLSMALLINT    year;
    SQLUSMALLINT   month;
    SQLUSMALLINT   day;
  } DATE_STRUCT;
TIME_STRUCT
typedef struct TIME_STRUCT
  {
    SQLUSMALLINT   hour;
    SQLUSMALLINT   minute;
    SQLUSMALLINT   second;
  } TIME_STRUCT;
TIMESTAMP_STRUCT
typedef struct TIMESTAMP_STRUCT
  {
    SQLUSMALLINT   year;
    SQLUSMALLINT   month;
    SQLUSMALLINT   day;
    SQLUSMALLINT   hour;
    SQLUSMALLINT   minute;
    SQLUSMALLINT   second;
    SQLINTEGER     fraction;
  } TIMESTAMP_STRUCT;
変更の始まりTIMESTAMP_STRUCT_EXT変更の終わり 変更の始まり
typedef struct TIMESTAMP_STRUCT_EXT
{
  SQLUSMALLINT year;
  SQLUSMALLINT month;
  SQLUSMALLINT day;
  SQLUSMALLINT hour;
  SQLUSMALLINT minute;
  SQLUSMALLINT second;
  SQLINTEGER fraction;
  SQLINTEGER fraction2;
} TIMESTAMP_STRUCT_EXT;
変更の終わり
SQLDECIMAL64
typedef struct SQLDECIMAL64
{
  union{
    SQLDOUBLE dummy;
    SQLCHAR dec64[8];
  }dec64;
} SQLDECIMAL64;
SQLDECIMAL128
typedef struct SQLDECIMAL128
{
  union{
    SQLDOUBLE dummy;
    SQLCHAR dec128[16];
  }dec128;
} SQLDECIMAL128;