날짜/시간 형식에 대한 sql_variant 지원
이 항목에서는 sql_variant 데이터 형식에서 향상된 날짜 및 시간 기능을 지원하는 방법에 대해 설명합니다.
열 특성 SQL_CA_SS_VARIANT_TYPE은 C 형식의 variant 결과 열을 반환하는 데 사용됩니다. SQL Server 2008에서는 IRD(구현 행 설명자)에서 SQL 형식의 variant 결과 열을 설정하는 추가 특성 SQL_CA_SS_VARIANT_SQL_TYPE을 제공합니다. IPD(구현 매개 변수 설명자)에서 SQL_SS_VARIANT 형식으로 바인딩된 SQL_C_BINARY C 형식을 갖는 SQL 형식의 SQL_SS_TIME2 또는 SQL_SS_TIMESTAMPOFFSET 매개 변수를 지정하는 데에도 SQL_CA_SS_VARIANT_SQL_TYPE을 사용할 수 있습니다.
새 형식 SQL_SS_TIME2 및 SQL_SS_TIMESTAMPOFFSET은 SQLColAttribute에서 설정할 수 있습니다. SQL_CA_SS_VARIANT_SQL_TYPE은 SQLGetDescField에서 반환할 수 있습니다.
결과 열의 경우 드라이버에서는 variant를 날짜/시간 형식으로 변환합니다. 자세한 내용은 SQL에서 C로 변환을 참조하십시오. SQL_C_BINARY에 바인딩할 때 버퍼 길이가 SQL 형식에 해당하는 구조체를 받을 수 있을 만큼 커야 합니다.
SQL_SS_TIME2 및 SQL_SS_TIMESTAMPOFFSET 매개 변수의 경우 드라이버에서는 아래 표에 설명된 대로 C 값을 sql_variant 값으로 변환합니다. 매개 변수가 SQL_C_BINARY로 바인딩되어 있고 서버 형식이 SQL_SS_VARIANT인 경우에는 응용 프로그램에서 SQL_CA_SS_VARIANT_SQL_TYPE을 다른 SQL 형식으로 설정한 경우 외에는 이진 값으로 처리됩니다. 이 경우 SQL_CA_SS_VARIANT_SQL_TYPE이 우선 순위가 높습니다. 즉, SQL_CA_SS_VARIANT_SQL_TYPE이 설정된 경우 C 형식에서 variant SQL 형식을 추론하는 기본 동작이 무시됩니다.
C 형식 |
서버 형식 |
설명 |
|---|---|---|
SQL_C_CHAR |
varchar |
SQL_CA_SS_VARIANT_SQL_TYPE이 무시됩니다. |
SQL_C_WCHAR |
nvarcar |
SQL_CA_SS_VARIANT_SQL_TYPE이 무시됩니다. |
SQL_C_TINYINT |
smallint |
SQL_CA_SS_VARIANT_SQL_TYPE이 무시됩니다. |
SQL_C_STINYINT |
smallint |
SQL_CA_SS_VARIANT_SQL_TYPE이 무시됩니다. |
SQL_C_SHORT |
smallint |
SQL_CA_SS_VARIANT_SQL_TYPE이 무시됩니다. |
SQL_C_SSHORT |
smallint |
SQL_CA_SS_VARIANT_SQL_TYPE이 무시됩니다. |
SQL_C_USHORT |
int |
SQL_CA_SS_VARIANT_SQL_TYPE이 무시됩니다. |
SQL_C_LONG |
int |
SQL_CA_SS_VARIANT_SQL_TYPE이 무시됩니다. |
SQL_C_SLONG |
int |
SQL_CA_SS_VARIANT_SQL_TYPE이 무시됩니다. |
SQL_C_ULONG |
bigint |
SQL_CA_SS_VARIANT_SQL_TYPE이 무시됩니다. |
SQL_C_SBIGINT |
bigint |
SQL_CA_SS_VARIANT_SQL_TYPE이 무시됩니다. |
SQL_C_FLOAT |
real |
SQL_CA_SS_VARIANT_SQL_TYPE이 무시됩니다. |
SQL_C_DOUBLE |
float |
SQL_CA_SS_VARIANT_SQL_TYPE이 무시됩니다. |
SQL_C_BIT |
bit |
SQL_CA_SS_VARIANT_SQL_TYPE이 무시됩니다. |
SQL_C_UTINYINT |
tinyint |
SQL_CA_SS_VARIANT_SQL_TYPE이 무시됩니다. |
SQL_C_BINARY |
varbinary |
SQL_CA_SS_VARIANT_SQL_TYPE이 설정되지 않습니다. |
SQL_C_BINARY |
time |
SQL_CA_SS_VARIANT_SQL_TYPE = SQL_SS_TIME2 소수 자릿수가 SQL_DESC_PRECISION(SQLBindParameter의 DecimalDigits 매개 변수)으로 설정됩니다. |
SQL_C_BINARY |
datetimeoffset |
SQL_CA_SS_VARIANT_SQL_TYPE= SQL_SS_TIMESTAMPOFFSET 소수 자릿수가 SQL_DESC_PRECISION(SQLBindParameter의 DecimalDigits 매개 변수)으로 설정됩니다. |
SQL_C_TYPE_DATE |
date |
SQL_CA_SS_VARIANT_SQL_TYPE이 무시됩니다. |
SQL_C_TYPE_TIME |
time(0) |
SQL_CA_SS_VARIANT_SQL_TYPE이 무시됩니다. |
SQL_C_TYPE_TIMESTAMP |
datetime2 |
소수 자릿수가 SQL_DESC_PRECISION(SQLBindParameter의 DecimalDigits 매개 변수)으로 설정됩니다. |
SQL_C_NUMERIC |
decimal |
전체 자릿수가 SQL_DESC_PRECISION(SQLBindParameter의 ColumnSize 매개 변수)으로 설정됩니다. 소수 자릿수가 SQL_DESC_SCALE(SQLBindParameter의 DecimalDigits 매개 변수)로 설정됩니다. |