通过

元数据 - 参数和行集

  • 项目

适用于：SQL Server Azure SQL 数据库 Azure SQL 托管实例 Azure Synapse Analytics Analytics 平台系统（PDW）

下载 OLE DB 驱动程序

本文提供了与 OLE DB 日期和时间增强功能相关的以下类型和类型成员的相关信息。

  • DBBINDING 结构

  • ICommandWithParameters::GetParameterInfo

  • ICommandWithParameters::SetParameterInfo

  • IColumnsRowset::GetColumnsRowset

  • IColumnsInfo::GetColumnInfo

ICommandWithParameters::GetParameterInfo

通过 prgParamInfo 在 DBPARAMINFO 结构中返回以下信息 ：

参数类型 wType ulParamSize bPrecision bScale dwFlags

DBPARAMFLAGS_SS_ISVARIABLESCALE
date DBTYPE_DBDATE 6 10 0 Clear
time DBTYPE_DBTIME2 10 8, 10..16 0..7 Set
smalldatetime DBTYPE_DBTIMESTAMP 16 16 0 Clear
datetime DBTYPE_DBTIMESTAMP 16 23 3 Clear
datetime2 DBTYPE_DBTIMESTAMP 16 19、21..27 0..7 Set
datetimeoffset DBTYPE_DBTIMESTAMPOFFSET 20 26、28..34 0..7 Set

请注意，在某些情况下，值范围不是连续的。 这是因为当小数精度大于零时添加了小数点。

仅当连接到运行 SQL Server 2008 (10.0.x) 及更高版本的服务器时，DBPARAMFLAGS_SS_ISVARIABLESCALE 才有效。 当连接到下级服务器时，永远不会设置 DBPARAMFLAGS_SS_ISVARIABLESCALE。

ICommandWithParameters::SetParameterInfo 和隐含的参数类型

在 DBPARAMBINDINFO 结构中提供的信息必须符合以下规定：

pwszDataSourceType

（特定于访问接口）		 pwszDataSourceType

（一般 OLE DB）		 ulParamSize bScale
DBTYPE_DATE 6 忽略
date DBTYPE_DBDATE 6 忽略
DBTYPE_DBTIME 10 忽略
time DBTYPE_DBTIME2 10 0..7
smalldatetime 16 忽略
datetime 16 忽略
datetime2 或 DBTYPE_DBTIMESTAMP DBTYPE_DBTIMESTAMP 16 0..7
datetimeoffset DBTYPE_DBTIMESTAMPOFFSET 20 0..7

bPrecision 参数将被忽略。

向服务器发送数据时将忽略“DBPARAMFLAGS_SS_ISVARIABLESCALE”。 通过使用特定于提供程序的类型名称“datetime”和“smalldatetime”，应用程序可以强制使用旧的表格格式数据流 (TDS) 类型 。 当连接到运行 SQL Server 2008 (10.0.x) 和更高版本的服务器时，如果类型名称为“datetime2”或“DBTYPE_DBTIMESTAMP”，将使用“datetime2”格式，并在必要时进行隐式服务器转换。 如果使用提供程序特定的类型名称“datetime”或“smalldatetime”，则将忽略 bScale。 否则，应用程序必须确保正确设置了 bScale 。 对于使用“DBTYPE_DBTIMESTAMP”且从 MDAC 升级的应用程序和 SQL Server 2005 (9.x) 的 OLE DB Driver for SQL Server，如果未正确设置 bScale ，应用程序将失败。 当连接到早于 SQL Server 2008 (10.0.x) 的服务器实例时，采用“DBTYPE_DBTIMESTAMP”且值不为 0 或 3 的 bScale 值不正确，并且将返回 E_FAIL。

如果未调用 ICommandWithParameters::SetParameterInfo，则提供程序将根据 IAccessor::CreateAccessor 中指定的绑定类型来表示服务器类型，如下所示：

绑定类型 pwszDataSourceType

（特定于访问接口）
DBTYPE_DATE datetime2(0)
DBTYPE_DBDATE date
DBTYPE_DBTIME time(0)
DBTYPE_DBTIME2 time(7)
DBTYPE_DBTIMESTAMP datetime2(7)
DBTYPE_DBTIMESTAMPOFFSET datetimeoffset(7)

IColumnsRowset::GetColumnsRowset

IColumnsRowset::GetColumnsRowset 返回以下列：

列类型 DBCOLUMN_TYPE DBCOLUM_COLUMNSIZE DBCOLUMN_PRECISION DBCOLUMN_SCALE、DBCOLUMN_DATETIMEPRECISION DBCOLUMN_FLAGS、DBCOLUMNFLAGS_SS_ISVARIABLESCALE
date DBTYPE_DBDATE 6 10 0 Clear
time DBTYPE_DBTIME2 10 8, 10..16 0..7 Set
smalldatetime DBTYPE_DBTIMESTAMP 16 16 0 Clear
datetime DBTYPE_DBTIMESTAMP 16 23 3 Clear
datetime2 DBTYPE_DBTIMESTAMP 16 19、21..27 0..7 Set
datetimeoffset DBTYPE_DBTIMESTAMPOFFSET 20 26、28..34 0..7 Set

在 DBCOLUMN_FLAGS 中，对于日期/时间类型，DBCOLUMNFLAGS_ISFIXEDLENGTH 始终为 True，而下列标志则始终为 False：

  • DBCOLUMNFLAGS_CACHEDEFERRED

  • DBCOLUMNFLAGS_ISBOOKMARK

  • DBCOLUMNFLAGS_ISCHAPTER

  • DBCOLUMNFLAGS_ISLONG

  • DBCOLUMNFLAGS_ISROWID

  • DBCOLUMNFLAGS_ISROWVER

  • DBCOLUMNFLAGS_MAYDEFER

可根据列的定义方式和实际查询设置其余标志（DBCOLUMNFLAGS_ISNULLABLE、DBCOLUMNFLAGS_MAYBENULL、DBCOLUMNFLAGS_WRITE 和 DBCOLUMNFLAGS_WRITEUNKNOWN）。

DBCOLUMN_FLAGS 中提供了新的 DBCOLUMNFLAGS_SS_ISVARIABLESCALE 标志，以使应用程序可以确定列的服务器类型，其中 DBCOLUMN_TYPE 为 DBTYPE_DBTIMESTAMP。 还必须使用 DBCOLUMN_SCALE 或 DBCOLUMN_DATETIMEPRECISION 标识服务器类型。

仅当连接到运行 SQL Server 2008 (10.0.x) 及更高版本的服务器时，DBCOLUMNFLAGS_SS_ISVARIABLESCALE 才有效。 当连接到下级服务器时，未定义 DBCOLUMNFLAGS_SS_ISVARIABLESCALE。

IColumnsInfo::GetColumnInfo

DBCOLUMNINFO 结构返回以下信息：

参数类型 wType ulColumnSize bPrecision bScale dwFlags

DBPARAMFLAGS_SS_ISVARIABLESCALE
date DBTYPE_DBDATE 6 10 0 Clear
time(1..7) DBTYPE_DBTIME2 10 8, 10..16 0..7 Set
smalldatetime DBTYPE_DBTIMESTAMP 16 16 0 Clear
datetime DBTYPE_DBTIMESTAMP 16 23 3 Clear
datetime2 DBTYPE_DBTIMESTAMP 16 19、21..27 0..7 Set
datetimeoffset DBTYPE_DBTIMESTAMPOFFSET 20 26、28..34 0..7 Set

在 dwFlags 中，对于日期/时间类型，DBCOLUMNFLAGS_ISFIXEDLENGTH 始终为 True，而下列标志则始终为 False ：

  • DBCOLUMNFLAGS_CACHEDEFERRED

  • DBCOLUMNFLAGS_ISBOOKMARK

  • DBCOLUMNFLAGS_ISCHAPTER

  • DBCOLUMNFLAGS_ISLONG

  • DBCOLUMNFLAGS_ISROWID

  • DBCOLUMNFLAGS_ISROWVER、MAYDEFER

可以设置其余标志（DBCOLUMNFLAGS_ISNULLABLE、DBCOLUMNFLAGS_MAYBENULL、DBCOLUMNFLAGS_WRITE 和 DBCOLUMNFLAGS_WRITEUNKNOWN）。

dwFlags 中提供了新的 DBCOLUMNFLAGS_SS_ISVARIABLESCALE 标志，以使应用程序可以确定列的服务器类型，其中 wType 为 DBTYPE_DBTIMESTAMP 。 还必须使用 bScale 来标识服务器类型 。

另请参阅

针对 OLE DB 日期和时间改进的数据类型支持