以前のバージョンの SQL Server における、強化された日付型と時刻型の動作 (ODBC)

このトピックでは、強化された日付や時刻の機能を使用するクライアントアプリケーションが SQL Server 2008 より前のバージョンの SQL Server と通信する場合、および Microsoft Data Access Components、Windows Data Access Components、または SQL Server 2008 より前のバージョンの SQL Server Native Client を使用しているクライアントアプリケーションから、機能強化された日付や時刻をサポートするサーバーへコマンドを送信する場合に想定される動作について説明します。

下位クライアントの動作

SQL Server 2008 より前のバージョンの SQL Server Native Client を使用してコンパイルされたクライアントアプリケーションでは、新しい日付型と時刻型が nvarchar 列と見なされます。「ODBC の日付/時刻の強化に対するデータ型のサポート」の「データ形式 : 文字列とリテラル」で説明されているように、列のコンテンツはリテラル表現になります。列のサイズは、列に指定された秒の小数部の有効桁数に対するリテラルの最大長です。

カタログ API によって、クライアントに返される下位データ型のコード (nvarchar など) および関連する下位の表現 (適切なリテラル形式など) と一貫性のあるメタデータが返されます。ただし、返されるデータ型名は、実際の SQL Server 2008 の型名です。

SQLDescribeCol、SQLDescribeParam、SQGetDescField、および SQLColAttribute は、型名を含むあらゆる点で下位型と一貫性のあるステートメントメタデータを返します。 nvarchar は、このような下位型の一例です。

日付型または時刻型へのスキーマ変更が加えられた SQL Server 2008 以降のサーバーに対して下位クライアントアプリケーションが実行された場合に、予想される動作は次のとおりです。

SQL Server 2005 の型	SQL Server 2008 以降の型	ODBC クライアントの型	結果の変換 (SQL から C へ)	パラメーターの変換 (C から SQL へ)
Datetime	日付	SQL_C_TYPE_DATE	OK	OK (1)
		SQL_C_TYPE_TIMESTAMP	時刻フィールドは 0 に設定されます。	OK (2) 時刻フィールドが 0 以外の場合は失敗します。 SQL Server 2005 で機能します。
	Time(0)	SQL_C_TYPE_TIME	OK	OK (1)
		SQL_C_TYPE_TIMESTAMP	日付フィールドは現在の日付に設定されます。	OK (2) 日付は無視されます。秒の小数部が 0 以外の場合は失敗します。 SQL Server 2005 で機能します。
	Time(7)	SQL_C_TIME	失敗します (時刻リテラルが無効です)。	OK (1)
		SQL_C_TYPE_TIMESTAMP	失敗します (時刻リテラルが無効です)。	OK (1)
	Datetime2(3)	SQL_C_TYPE_TIMESTAMP	OK	OK (1)
	Datetime2(7)	SQL_C_TYPE_TIMESTAMP	OK	クライアントでの変換により、値は 1/300 秒単位に丸められます。
Smalldatetime	日付	SQL_C_TYPE_DATE	OK	OK
		SQL_C_TYPE_TIMESTAMP	時刻フィールドは 0 に設定されます。	OK (2) 時刻フィールドが 0 以外の場合は失敗します。 SQL Server 2005 で機能します。
	Time(0)	SQL_C_TYPE_TIME	OK	OK
		SQL_C_TYPE_TIMESTAMP	日付フィールドは現在の日付に設定されます。	OK (2) 日付は無視されます。秒の小数部が 0 以外の場合は失敗します。 SQL Server 2005 で機能します。
	Datetime2(0)	SQL_C_TYPE_TIMESTAMP	OK	OK

記号の説明

記号	意味
1	SQL Server 2005 で機能した場合には、新しいバージョンの SQL Server でも引き続き機能します。
2	SQL Server 2005 で機能したアプリケーションが、新しいバージョンの SQL Server では機能しない可能性があります。

一般的なスキーマ変更のみが考慮されていることに注意してください。一般的な変更は次のとおりです。

論理的にアプリケーションで日付値または時刻値のみが必要な場合に、新しい型を使用します。ただし、個別の日付型および時刻型がないため、アプリケーションでは datetime または smalldatetime の使用が強制されました。
追加の秒の小数部の有効桁数または精度を取得するために、新しい型を使用します。
日付と時刻に推奨されるデータ型なので datetime2 に切り替えます。

SQLColumns、SQLProcedureColumns、および SQLSpecialColumns から返される列のメタデータ

日付型または時刻型に対して返される列の値を次に示します。

列の型	date	time	smalldatetime	datetime	datetime2	datetimeoffset
DATA_TYPE	SQL_WVARCHAR	SQL_WVARCHAR	SQL_TYPE_TIMESTAMP	SQL_TYPE_TIMESTAMP	SQL_WVARCHAR	SQL_WVARCHAR
TYPE_NAME	date	time	smalldatetime	datetime	datetime2	datetimeoffset
COLUMN_SIZE	10	8,10..16	16	23	19, 21..27	26, 28..34
BUFFER_LENGTH	20	16, 20..32	16	16	38, 42..54	52, 56..68
DECIMAL_DIGITS	NULL	NULL	0	3	NULL	NULL
SQL_DATA_TYPE	SQL_WVARCHAR	SQL_WVARCHAR	SQL_DATETIME	SQL_DATETIME	SQL_WVARCHAR	SQL_WVARCHAR
SQL_DATETIME_SUB	NULL	NULL	SQL_CODE_TIMESTAMP	SQL_CODE_TIMESTAMP	NULL	NULL
CHAR_OCTET_LENGTH	NULL	NULL	NULL	NULL	NULL	NULL
SS_DATA_TYPE	0	0	111	111	0	0

SQLSpecialColumns は、SQL_DATA_TYPE、SQL_DATETIME_SUB、CHAR_OCTET_LENGTH、または SS_DATA_TYPE を返しません。

SQLGetTypeInfo から返されるデータ型のメタデータ

日付型または時刻型に対して返される列の値を次に示します。

列の型	date	time	smalldatetime	datetime	datetime2	datetimeoffset
TYPE_NAME	date	time	smalldatetime	datetime	datetime2	datetimeoffset
DATA_TYPE	SQL_WVARCHAR	SQL_WVARCHAR	SQL_TYPE_TIMESTAMP	SQL_TYPE_TIMESTAMP	SQL_WVARCHAR	SQL_WVARCHAR
COLUMN_SIZE	10	16	16	23	27	34
LITERAL_PREFIX	‘	‘	‘	‘	‘	‘
LITERAL_SUFFIX	‘	‘	‘	‘	‘	‘
CREATE_PARAMS	NULL	NULL	NULL	NULL	NULL	NULL
NULLABLE	SQL_NULLABLE	SQL_NULLABLE	SQL_NULLABLE	SQL_NULLABLE	SQL_NULLABLE	SQL_NULLABLE
CASE_SENSITIVE	SQL_FALSE	SQL_FALSE	SQL_FALSE	SQL_FALSE	SQL_FALSE	SQL_FALSE
SEARCHABLE	SQL_PRED_SEARCHABLE	SQL_PRED_SEARCHABLE	SQL_PRED_SEARCHABLE	SQL_PRED_SEARCHABLE	SQL_PRED_SEARCHABLE	SQL_PRED_SEARCHABLE
UNSIGNED_ATTRIBUTE	NULL	NULL	NULL	NULL	NULL	NULL
FXED_PREC_SCALE	SQL_FALSE	SQL_FALSE	SQL_FALSE	SQL_FALSE	SQL_FALSE	SQL_FALSE
AUTO_UNIQUE_VALUE	NULL	NULL	NULL	NULL	NULL	NULL
LOCAL_TYPE_NAME	date	time	smalldatetime	datetime	datetime2	datetimeoffset
MINIMUM_SCALE	NULL	NULL	0	3	NULL	NULL
MAXIMUM_SCALE	NULL	NULL	0	3	NULL	NULL
SQL_DATA_TYPE	SQL_WVARCHAR	SQL_WVARCHAR	SQL_DATETIME	SQL_DATETIME	SQL_WVARCHAR	SQL_WVARCHAR
SQL_DATETIME_SUB	NULL	NULL	SQL_CODE_TIMESTAMP	SQL_CODE_TIMESTAMP	NULL	NULL
NUM_PREC_RADIX	NULL	NULL	NULL	NULL	NULL	NULL
INTERVAL_PRECISION	NULL	NULL	NULL	NULL	NULL	NULL
USERTYPE	0	0	12	22	0	0

下位サーバーの動作

SQL Server 2008 より前のバージョンのサーバーインスタンスに接続している場合、新しいサーバーの型または関連するメタデータコードおよび記述子フィールドを使用しようとすると、SQL_ERROR が返されます。 "接続しているサーバーのバージョンに対して、SQL データ型が無効です" というメッセージで SQLSTATE HY004 の診断レコード、または、"データ型の属性に関する制限に違反しました" というメッセージで SQLSTATE 07006 の診断レコードが生成されます。