データ変換

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 およ び 表 2 は、Db2 ODBC がサポートする変換を示しています。

表 1 は、SQL タイプ別に変換をリストしています。 この表の最初の欄には、SQL タイプが含まれています。この表の 2 番目の欄は、 ターゲット・タイプとして SQL_C_DEFAULT を指定したときに、SQL タイプが変換される デフォルトの C タイプが含まれています。 最後の欄は、SQL データ・タイプから C データ・タイプへの変換でターゲットとして指定できる 他のすべての C タイプを示しています。
表 1. SQL データ・タイプによってサポートされるデータ変換
SQL シンボリック・データ・タイプ デフォルトの C シンボリック・データ・タイプ 追加の C シンボリック・データ・タイプ
SQL_BIGINT SQL_C_BIGINT
  • SQL_C_CHAR
  • SQL_C_WCHAR
  • SQL_C_SHORT
  • SQL_C_LONG
  • SQL_C_TINYINT
  • SQL_C_BIT
  • SQL_C_FLOAT
  • SQL_C_DOUBLE
  • SQL_C_DECIMAL64
  • SQL_C_DECIMAL128
SQL_BINARY SQL_C_BINARY
  • SQL_C_CHAR
  • SQL_C_WCHAR
SQL_BLOB SQL_C_BINARY SQL_C_CHAR1 SQL_C_WCHAR2 SQL_C_BLOB_LOCATOR3
SQL_CHAR SQL_C_CHAR1
  • SQL_C_WCHAR2
  • SQL_C_LONG
  • SQL_C_SHORT
  • SQL_C_TINYINT
  • SQL_C_BIGINT
  • SQL_C_FLOAT
  • SQL_C_DOUBLE
  • SQL_C_DECIMAL64
  • SQL_C_DECIMAL128
  • SQL_C_TYPE_DATE
  • SQL_C_TYPE_TIME
  • SQL_C_TYPE_TIMESTAMP
  • SQL_C_BINARY
  • SQL_C_BIT
SQL_CLOB SQL_C_CHAR1 SQL_C_WCHAR2 SQL_C_BINARY SQL_C_CLOB_LOCATOR3
SQL_DBCLOB SQL_C_DBCHAR
  • SQL_C_WCHAR2
  • SQL_C_BINARY
  • SQL_C_DBCLOB_LOCATOR3
SQL_DECFLOAT SQL_C_CHAR1
  • SQL_C_WCHAR2
  • SQL_C_LONG
  • SQL_C_SHORT
  • SQL_C_TINYINT
  • SQL_C_FLOAT
  • SQL_C_DOUBLE
  • SQL_C_BIT
  • SQL_C_BIGINT
  • SQL_C_DECIMAL64
  • SQL_C_DECIMAL128
SQL_DECIMAL SQL_C_CHAR1
  • SQL_C_WCHAR2
  • SQL_C_LONG
  • SQL_C_SHORT
  • SQL_C_TINYINT
  • SQL_C_FLOAT
  • SQL_C_DOUBLE
  • SQL_C_DECIMAL64
  • SQL_C_DECIMAL128
  • SQL_C_BIT
SQL_DOUBLE SQL_C_DOUBLE
  • SQL_C_CHAR1
  • SQL_C_WCHAR2
  • SQL_C_LONG
  • SQL_C_SHORT
  • SQL_C_TINYINT
  • SQL_C_FLOAT
  • SQL_C_DECIMAL64
  • SQL_C_DECIMAL128
  • SQL_C_BIT
SQL_FLOAT SQL_C_DOUBLE
  • SQL_C_CHAR1
  • SQL_C_WCHAR2
  • SQL_C_LONG
  • SQL_C_SHORT
  • SQL_C_TINYINT
  • SQL_C_FLOAT
  • SQL_C_DECIMAL64
  • SQL_C_DECIMAL128
  • SQL_C_BIT
SQL_GRAPHIC SQL_C_DBCHAR または SQL_C_WCHAR4 SQL_C_CHAR1
SQL_INTEGER SQL_C_LONG
  • SQL_C_CHAR1
  • SQL_C_WCHAR2
  • SQL_C_SHORT
  • SQL_C_TINYINT
  • SQL_C_FLOAT
  • SQL_C_DOUBLE
  • SQL_C_DECIMAL64
  • SQL_C_DECIMAL128
  • SQL_C_BIT
SQL_LONGVARBINARY SQL_C_BINARY SQL_C_CHAR SQL_C_WCHAR
SQL_LONGVARCHAR SQL_C_CHAR1
  • SQL_C_WCHAR2
  • SQL_C_BINARY
  • SQL_C_DECIMAL64
  • SQL_C_DECIMAL128
SQL_LONGVARGRAPHIC SQL_C_DBCHAR または SQL_C_WCHAR4 SQL_C_CHAR1
SQL_NUMERIC5 SQL_C_CHAR1
  • SQL_C_WCHAR2
  • SQL_C_SHORT
  • SQL_C_LONG
  • SQL_C_TINYINT
  • SQL_C_FLOAT
  • SQL_C_DOUBLE
  • SQL_C_DECIMAL64
  • SQL_C_DECIMAL128
  • SQL_C_BIT
SQL_REAL SQL_C_FLOAT
  • SQL_C_CHAR1
  • SQL_C_WCHAR2
  • SQL_C_SHORT
  • SQL_C_LONG
  • SQL_C_TINYINT
  • SQL_C_DOUBLE
  • SQL_C_DECIMAL64
  • SQL_C_DECIMAL128
  • SQL_C_BIT
SQL_ROWID SQL_C_CHAR SQL_C_WCHAR
SQL_SMALLINT SQL_C_SHORT
  • SQL_C_CHAR1
  • SQL_C_WCHAR2
  • SQL_C_LONG
  • SQL_C_TINYINT
  • SQL_C_FLOAT
  • SQL_C_DOUBLE
  • SQL_C_DECIMAL64
  • SQL_C_DECIMAL128
  • SQL_C_BINARY
  • SQL_C_BIT
SQL_TYPE_DATE SQL_C_TYPE_DATE
  • SQL_C_CHAR1
  • SQL_C_WCHAR2
  • SQL_C_TYPE_TIMESTAMP
SQL_TYPE_TIME SQL_C_TYPE_TIME
  • SQL_C_CHAR1
  • SQL_C_WCHAR2
  • SQL_C_TYPE_TIMESTAMP
変更の始まりSQL_TYPE_TIMESTAMP変更の終わり 変更の始まり
SQL_C_TYPE_TIMESTAMP
SQL_C_TYPE_TIMESTAMP_EXT
変更の終わり
変更の始まり
  • SQL_C_CHAR1
  • SQL_C_WCHAR2
  • SQL_C_TYPE_DATE
  • SQL_C_TYPE_TIME
変更の終わり
SQL_VARBINARY SQL_C_BINARY SQL_C_CHAR SQL_C_WCHAR
SQL_VARCHAR SQL_C_CHAR1
  • SQL_C_WCHAR2
  • SQL_C_SHORT
  • SQL_C_LONG
  • SQL_C_TINYINT
  • SQL_C_FLOAT
  • SQL_C_DOUBLE
  • SQL_C_DECIMAL64
  • SQL_C_DECIMAL128
  • SQL_C_BINARY
  • SQL_C_BIT
  • SQL_C_TYPE_DATE
  • SQL_C_TYPE_TIME
  • SQL_C_TYPE_TIMESTAMP
SQL_VARGRAPHIC SQL_C_DBCHAR または SQL_C_WCHAR4 SQL_C_CHAR1
SQL_XML SQL_C_BINARY
  • SQL_C_BINARYXML
  • SQL_C_CHAR
  • SQL_C_DBCHAR
  • SQL_C_WCHAR
注:
  1. データをユニコード UTF-8 データ用 の SQL_C_CHAR データ・タイプにバインドする必要があります。
  2. データをユニコード UCS-2 データ用の SQL_C_WCHAR データ・タイプに バインドする必要があります。
  3. データは LOB ロケーター・タイプに変換されません。ロケーターはデータ値を表します。
  4. この SQL データ・タイプのデフォルトの C データ・タイプ変換は、アプリケーションが 使用するコード化スキームに依存しています。 アプリケーションが UCS-2 ユニコード・エンコード方式を使用している場合は、デフォルト は SQL_C_WCHAR への変換です。 その他すべてのコード化スキームの場合は、デフォルトは SQL_C_DBCHAR への変換です。
  5. Db2 for z/OS®、DB2® for VSE & VM、および Db2 for Linux, UNIX, and Windows では、NUMERIC は DECIMAL の同義語です。
表 2 は、C タイプによる変換を示しています。 この表の最初の欄には、これらの C タイプが含まれています。 この表の 2 番目の欄は、 デフォルトの変換で最初の欄の C タイプを使用する SQL タイプが含まれています。 最後の欄は、C データ・タイプから SQL データ・タイプへの変換で指定できる 他のすべての SQL タイプを示しています。
表 2. C データ・タイプによってサポートされるデータ変換
シンボリック C データ・
タイプ
この C データ・タイプをデフォルトとして 使用するシンボリック SQL データ・タイプ 追加のシンボリック SQL データ・タイプ
SQL_C_BIGINT SQL_BIGINT
  • SQL_CHAR
  • SQL_DECIMAL
  • SQL_DOUBLE
  • SQL_FLOAT
  • SQL_INTEGER
  • SQL_NUMERIC
  • SQL_REAL
  • SQL_DECFLOAT
  • SQL_SMALLINT
  • SQL_VARCHAR
SQL_C_CHAR1
  • SQL_CHAR
  • SQL_CLOB
  • SQL_DECFLOAT
  • SQL_DECIMAL
  • SQL_LONGVARCHAR
  • SQL_NUMERIC2
  • SQL_VARCHAR
  • SQL_BLOB
  • SQL_DOUBLE
  • SQL_FLOAT
  • SQL_GRAPHIC
  • SQL_INTEGER
  • SQL_LONGVARGRAPHIC
  • SQL_REAL
  • SQL_ROWID
  • SQL_SMALLINT
  • SQL_TYPE_DATE
  • SQL_TYPE_TIME
  • SQL_TYPE_TIMESTAMP
  • SQL_VARGRAPHIC
  • SQL_XML
SQL_C_WCHAR3
  • SQL_GRAPHIC5
  • SQL_LONGVARGRAPHIC5
  • SQL_VARGRAPHIC5
  • SQL_BLOB
  • SQL_CHAR
  • SQL_CLOB
  • SQL_DECIMAL
  • SQL_DECFLOAT
  • SQL_DOUBLE
  • SQL_FLOAT
  • SQL_INTEGER
  • SQL_LONGVARCHAR
  • SQL_NUMERIC2
  • SQL_REAL
  • SQL_ROWID
  • SQL_SMALLINT
  • SQL_TYPE_DATE
  • SQL_TYPE_TIME
  • SQL_TYPE_TIMESTAMP
  • SQL_VARCHAR
  • SQL_XML
SQL_C_LONG SQL_INTEGER
  • SQL_CHAR
  • SQL_DECIMAL
  • SQL_DOUBLE
  • SQL_FLOAT
  • SQL_NUMERIC2
  • SQL_REAL
  • SQL_DECFLOAT
  • SQL_SMALLINT
  • SQL_VARCHAR
SQL_C_SHORT SQL_SMALLINT
  • SQL_CHAR
  • SQL_DECIMAL
  • SQL_DOUBLE
  • SQL_FLOAT
  • SQL_NUMERIC2
  • SQL_REAL
  • SQL_DECFLOAT
  • SQL_VARCHAR
SQL_C_TINYINT デフォルトの変換で、SQL_C_TINYINT を使用する SQL データ・タイプはない。
  • SQL_CHAR
  • SQL_DECIMAL
  • SQL_DOUBLE
  • SQL_FLOAT
  • SQL_SMALLINT
  • SQL_INTEGER
  • SQL_NUMERIC2
  • SQL_REAL
  • SQL_DECFLOAT
  • SQL_VARCHAR
SQL_C_FLOAT SQL_REAL
  • SQL_CHAR
  • SQL_DECIMAL
  • SQL_DOUBLE
  • SQL_FLOAT
  • SQL_SMALLINT
  • SQL_INTEGER
  • SQL_NUMERIC2
  • SQL_DECFLOAT
  • SQL_VARCHAR
SQL_C_DOUBLE SQL_DOUBLE SQL_FLOAT
  • SQL_CHAR
  • SQL_DECIMAL
  • SQL_SMALLINT
  • SQL_INTEGER
  • SQL_NUMERIC2
  • SQL_REAL
  • SQL_DECFLOAT
  • SQL_VARCHAR
SQL_C_DECIMAL64 デフォルトの変換で、SQL_C_DECIMAL64 を使用する SQL データ・タイプはない。
  • SQL_CHAR
  • SQL_DECIMAL
  • SQL_FLOAT
  • SQL_DECFLOAT
  • SQL_DOUBLE
  • SQL_INTEGER
  • SQL_NUMERIC
  • SQL_REAL
  • SQL_SMALLINT
  • SQL_BIGINT
  • SQL_VARCHAR
  • SQL_LONGVARCHAR
SQL_C_DECIMAL128 デフォルトの変換で、SQL_C_DECIMAL128 を使用する SQL データ・タイプはない。
  • SQL_CHAR
  • SQL_DECIMAL
  • SQL_FLOAT
  • SQL_DECFLOAT
  • SQL_DOUBLE
  • SQL_INTEGER
  • SQL_NUMERIC
  • SQL_REAL
  • SQL_SMALLINT
  • SQL_BIGINT
  • SQL_VARCHAR
  • SQL_LONGVARCHAR
SQL_C_TYPE_DATE SQL_TYPE_DATE
  • SQL_CHAR
  • SQL_TYPE_TIMESTAMP
  • SQL_VARCHAR
SQL_C_TYPE_TIME SQL_TYPE_TIME
  • SQL_CHAR
  • SQL_TYPE_TIMESTAMP
  • SQL_VARCHAR
SQL_C_TYPE_TIMESTAMP SQL_TYPE_TIMESTAMP
  • SQL_CHAR
  • SQL_TYPE_DATE
  • SQL_TYPE_TIME
  • SQL_VARCHAR
変更の始まりSQL_C_TYPE_TIMESTAMP_EXT 変更の終わり 変更の始まりSQL_TYPE_TIMESTAMP変更の終わり 変更の始まり
  • SQL_CHAR
  • SQL_TYPE_DATE
  • SQL_TYPE_TIME
  • SQL_VARCHAR
変更の終わり
SQL_C_BINARY
  • SQL_BINARY
  • SQL_VARBINARY
  • SQL_LONGVARBINARY
  • SQL_BLOB
  • SQL_XML
  • SQL_CHAR
  • SQL_CLOB
  • SQL_LONGVARCHAR
  • SQL_LONGVARGRAPHIC
  • SQL_VARCHAR
SQL_C_BINARYXML デフォルトの変換で、SQL_C_BINARYXML を使用する SQL タイプはない。 SQL_XML
SQL_C_BIT デフォルトの変換で、SQL_C_BIT を使用する SQL タイプはない。
  • SQL_CHAR
  • SQL_DECIMAL
  • SQL_DOUBLE
  • SQL_FLOAT
  • SQL_SMALLINT
  • SQL_INTEGER
  • SQL_NUMERIC2
  • SQL_REAL
  • SQL_DECFLOAT
  • SQL_VARCHAR
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
注:
  1. データをユニコード UTF-8 データ用 の SQL_C_CHAR データ・タイプにバインドする必要があります。
  2. Db2 for z/OS、DB2 for VSE & VM、および Db2 for Linux, UNIX, and Windows では、NUMERIC は DECIMAL の同義語です。
  3. データをユニコード UCS-2 データ用の SQL_C_WCHAR データ・タイプに バインドする必要があります。
  4. データは LOB ロケーター・タイプに変換されません。ロケーターはデータ値を表します。
  5. この SQL データ・タイプのデフォルトの C データ・タイプ変換は、アプリケーションが 使用するコード化スキームに依存しています。 アプリケーションが UCS-2 ユニコード・エンコード方式を使用している場合は、デフォルト は SQL_C_WCHAR への変換です。 その他すべてのコード化スキームの場合は、デフォルトは SQL_C_DBCHAR への変換です。

切り捨てと丸めの規則のほか、精度の限界および位取りについては、 Db2 for z/OS の場合と同じですが、 例外として、数値の小数点の右側の値が切り捨てられた場合は 切り捨ての警告が戻されるのに対して、小数点の左側が切り捨てられた場合はエラーが戻されます。 エラーの場合には、アプリケーションは、SQLGetDiagRec() を 呼び出して、障害についての SQLSTATE および追加情報を得る必要があります。 浮動小数点データ値をアプリケーションと Db2 ODBC 間で移動および変換する場合、 値が精度および位取りの点で変わる可能性があるため、その対応が正確である保証はありません。