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 です。
| 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 |
| 注:
追加情報:
|
||
表 2 では、それぞれの C シンボリック・タイプごとに、総称 C タイプの
定義を示しています。
この表には、以下の欄があります。
- C シンボリック・データ・タイプ
- この欄では、整数値として定義された C シンボル名を示しています。これらの値は、最後の欄に示された C データ・タイプを示すために、 さまざまな関数の引数で使用されます。
- C タイプ
- この欄は C で定義されたタイプを示しています。 これは、C typedef ステートメントを使用して sqlcli1.h で定義されます。 アプリケーションの移植性を高めるために、この欄の値を使用して、 すべての Db2 ODBC 関連の変数および引数を宣言してください。
- 基本 C タイプ
- この欄は参照目的用にのみ、示してあります。 すべての変数および引数は、これより前の欄にあるシンボリック・タイプ を使用して定義してください。一部の値は 表 3 で説明されている 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 |
| 注:
|
||
次の表は、日付、時刻、タイム・スタンプ、および 10 進浮動小数点の C データ・タイプとそれに関連する構造をリストしています。
| C タイプ | 一般構造 |
|---|---|
| DATE_STRUCT |
|
| TIME_STRUCT |
|
| TIMESTAMP_STRUCT |
|
TIMESTAMP_STRUCT_EXT![]() |
![]()
![]() |
| SQLDECIMAL64 |
|
| SQLDECIMAL128 |
|

