データ変換
Db2® ODBC は、アプリケーションとデータベース・サーバーとの間のデータの転送と必要な変換を管理します。しかし、すべてのデータ変換がサポートされるわけではありません。
データ転送が実際に行われる前に、ソースまたはターゲット (あるいはその両方) の データ・タイプが、SQLBindParameter()、SQLBindCol()、または SQLGetData() を呼び出す 際に示されます。これらの関数は表示されたシンボリック・タイプ名を使用して、データ転送に伴うデータ・タイプを識別します。
例: 次の SQLBindParameter() 呼び出し
は、SQL データ・タイプ DECIMAL(5,3) に対応するパラメーター・マーカーを、
アプリケーションの C バッファー・タイプ DOUBLE にバインドします。
SQLBindParameter (hstmt, 1, SQL_PARAM_INPUT, SQL_C_DOUBLE,
SQL_DECIMAL, 5, 3, double_ptr, NULL);
前の段落で説明した関数を使用して、データを他のタイプに変換することができます。 ただし、すべてのデータ変換がサポートされているわけではなく、意味があるわけでも ありません。表 1 は、Db2 ODBC がサポートするすべての 変換を示しています。
表 1 は、SQL タイプ別に変換をリストしています。
この表の最初の欄には、SQL タイプが含まれています。この表の 2 番目の欄は、
ターゲット・タイプとして SQL_C_DEFAULT を指定したときに、SQL タイプが変換される
デフォルトの C タイプが含まれています。
最後の欄は、SQL データ・タイプから C データ・タイプへの変換でターゲットとして指定できる
他のすべての C タイプを示しています。
| SQL シンボリック・データ・タイプ | デフォルトの C シンボリック・データ・タイプ | 追加の C シンボリック・データ・タイプ |
|---|---|---|
| SQL_BIGINT | SQL_C_BIGINT |
|
| SQL_BINARY | SQL_C_BINARY |
|
| SQL_BLOB | SQL_C_BINARY | SQL_C_CHAR1 SQL_C_WCHAR2 SQL_C_BLOB_LOCATOR3 |
| SQL_CHAR | SQL_C_CHAR1 |
|
| SQL_CLOB | SQL_C_CHAR1 | SQL_C_WCHAR2 SQL_C_BINARY SQL_C_CLOB_LOCATOR3 |
| SQL_DBCLOB | SQL_C_DBCHAR |
|
| SQL_DECFLOAT | SQL_C_CHAR1 |
|
| SQL_DECIMAL | SQL_C_CHAR1 |
|
| SQL_DOUBLE | SQL_C_DOUBLE |
|
| SQL_FLOAT | SQL_C_DOUBLE |
|
| SQL_GRAPHIC | SQL_C_DBCHAR または SQL_C_WCHAR4 | SQL_C_CHAR1 |
| SQL_INTEGER | SQL_C_LONG |
|
| SQL_LONGVARBINARY | SQL_C_BINARY | SQL_C_CHAR SQL_C_WCHAR |
| SQL_LONGVARCHAR | SQL_C_CHAR1 |
|
| SQL_LONGVARGRAPHIC | SQL_C_DBCHAR または SQL_C_WCHAR4 | SQL_C_CHAR1 |
| SQL_NUMERIC5 | SQL_C_CHAR1 |
|
| SQL_REAL | SQL_C_FLOAT |
|
| SQL_ROWID | SQL_C_CHAR | SQL_C_WCHAR |
| SQL_SMALLINT | SQL_C_SHORT |
|
| SQL_TYPE_DATE | SQL_C_TYPE_DATE |
|
| SQL_TYPE_TIME | SQL_C_TYPE_TIME |
|
SQL_TYPE_TIMESTAMP![]() |
![]() SQL_C_TYPE_TIMESTAMP
SQL_C_TYPE_TIMESTAMP_EXT ![]() |
![]()
![]() |
| SQL_VARBINARY | SQL_C_BINARY | SQL_C_CHAR SQL_C_WCHAR |
| SQL_VARCHAR | SQL_C_CHAR1 |
|
| SQL_VARGRAPHIC | SQL_C_DBCHAR または SQL_C_WCHAR4 | SQL_C_CHAR1 |
| SQL_XML | SQL_C_BINARY |
|
注:
|
||
表 2 は、C タイプによる変換を示しています。
この表の最初の欄には、これらの C タイプが含まれています。 この表の 2 番目の欄は、
デフォルトの変換で最初の欄の C タイプを使用する SQL タイプが含まれています。
最後の欄は、C データ・タイプから SQL データ・タイプへの変換で指定できる
他のすべての SQL タイプを示しています。
| シンボリック C データ・ タイプ |
この C データ・タイプをデフォルトとして 使用するシンボリック SQL データ・タイプ | 追加のシンボリック SQL データ・タイプ |
|---|---|---|
| SQL_C_BIGINT | SQL_BIGINT |
|
| SQL_C_CHAR1 |
|
|
| SQL_C_WCHAR3 |
|
|
| SQL_C_LONG | SQL_INTEGER |
|
| SQL_C_SHORT | SQL_SMALLINT |
|
| SQL_C_TINYINT | デフォルトの変換で、SQL_C_TINYINT を使用する SQL データ・タイプはない。 |
|
| SQL_C_FLOAT | SQL_REAL |
|
| SQL_C_DOUBLE | SQL_DOUBLE SQL_FLOAT |
|
| SQL_C_DECIMAL64 | デフォルトの変換で、SQL_C_DECIMAL64 を使用する SQL データ・タイプはない。 |
|
| SQL_C_DECIMAL128 | デフォルトの変換で、SQL_C_DECIMAL128 を使用する SQL データ・タイプはない。 |
|
| SQL_C_TYPE_DATE | SQL_TYPE_DATE |
|
| SQL_C_TYPE_TIME | SQL_TYPE_TIME |
|
| SQL_C_TYPE_TIMESTAMP | SQL_TYPE_TIMESTAMP |
|
SQL_C_TYPE_TIMESTAMP_EXT
![]() |
SQL_TYPE_TIMESTAMP![]() |
![]()
![]() |
| SQL_C_BINARY |
|
|
| SQL_C_BINARYXML | デフォルトの変換で、SQL_C_BINARYXML を使用する SQL タイプはない。 | SQL_XML |
| SQL_C_BIT | デフォルトの変換で、SQL_C_BIT を使用する SQL タイプはない。 |
|
| SQL_C_DBCHAR | SQL_DBCLOB SQL_GRAPHIC5 SQL_LONGVARGRAPHIC5 SQL_VARGRAPHIC5 | SQL_XML |
| SQL_C_CLOB_LOCATOR | デフォルトの変換で、SQL_C_CLOB_LOCATOR を使用する SQL データ・タイプはない。 | SQL_CLOB |
| SQL_C_BLOB_LOCATOR | デフォルトの変換で、SQL_C_BLOB_LOCATOR を使用する SQL データ・タイプはない。 | SQL_BLOB |
| SQL_C_DBCLOB_LOCATOR | デフォルトの変換で、SQL_C_DBCLOB_LOCATOR を使用する SQL データ・タイプはない。 | SQL_DBCLOB |
注:
|
||
切り捨てと丸めの規則のほか、精度の限界および位取りについては、 Db2 for z/OS の場合と同じですが、 例外として、数値の小数点の右側の値が切り捨てられた場合は 切り捨ての警告が戻されるのに対して、小数点の左側が切り捨てられた場合はエラーが戻されます。 エラーの場合には、アプリケーションは、SQLGetDiagRec() を 呼び出して、障害についての SQLSTATE および追加情報を得る必要があります。 浮動小数点データ値をアプリケーションと Db2 ODBC 間で移動および変換する場合、 値が精度および位取りの点で変わる可能性があるため、その対応が正確である保証はありません。
SQL_TYPE_TIMESTAMP