向表值参数中插入数据

SQL Server Native Client OLE DB 访问接口支持两种供使用者为表值参数行指定数据的模型:推送模型和请求模型。提供演示请求模型的示例;请参阅安装 SQL Server 示例和示例数据库的注意事项

注意注意

表值参数列要么必须在所有行中具有非默认值,要么必须在所有行中具有默认值。不能在某些行中具有默认值,而在其他行中不具有默认值。因此,在表值参数绑定中,表值参数行集列数据仅允许状态值 DBSTATUS_S_ISNULL 和 DBSTATUS_S_OK。DBSTATUS_S_DEFAULT 将导致失败,而绑定的状态值将设置为 DBSTATUS_E_BADSTATUS。

推送模型(在内存中加载所有表值参数数据)

推送模型类似于使用参数集(也即,ICommand::Execute 中的 DBPARAMS 参数)。仅当在未对 IRowset 接口执行自定义实现的情况下使用表值参数行集对象时,才使用推送模型。当表值参数行集中的行数较少且预计不会给应用程序带来过量内存压力时,建议使用推送模型。这比请求模型更简单,因为它向使用者应用程序要求的功能不会超过典型 OLE DB 应用程序中当前常用的功能。

使用者应在执行命令之前向访问接口提供所有表值参数数据。为提供数据,使用者为每个表值参数填充一个表值参数行集对象。表值参数行集对象显示行集 Insert、Set 和 Delete 操作,使用者将使用这些操作来操作表值参数数据。访问接口在执行时将从该表值参数行集对象中提取数据。

当向使用者提供表值参数行集对象时,使用者可以将其作为行集对象处理。使用者可以通过使用 IColumnsInfo::GetColumnInfoIColumnsRowset::GetColumnsRowset 接口方法获得每列的类型信息(类型、最大长度、精度和小数位数)。然后,使用者创建取值函数,以便为数据指定绑定。下一步是将数据行插入表值参数行集。这可以通过使用 IRowsetChange::InsertRow 实现。如果您必须操作数据,则也可以对表值参数行集对象使用 IRowsetChange::SetDataIRowsetChange::DeleteRows。表值参数行集对象将进行引用计数,这与流对象类似。

如果使用 IColumnsRowset::GetColumnsRowset,则对于结果列的行集对象,将存在对于 IRowset::GetNextRowsIRowset::GetDataIRowset::ReleaseRows 方法的后续调用。

在 SQL Server Native Client OLE DB 访问接口开始执行命令之后,将从该表值参数行集对象中提取表值参数值,并将其发送到服务器。

推送模型对于使用者的工作量要求最少,但占用的内存高于请求模型,原因在于在执行时所有表值参数数据都必须位于内存中。

请求模型(从使用者按需获得表值参数数据)

请求模型用于两种应用场景:

  • 使行成为流数据。

  • 如果其他访问接口中的行集正用作表值参数值。

在请求模型中,使用者按需为访问接口提供数据。如果应用程序具有许多数据插入操作,并且内存中的表值参数行集数据将导致过量的内存访问,则使用此方法。如果使用多个 OLE DB 访问接口,则借助于使用者请求模型,使用者可以将任何行集对象作为表值参数值提供。

为了使用请求模型,使用者必须提供其自己的对于行集对象的实现。当将请求模型用于表值参数行集 (CLSID_ROWSET_TVP) 时,将要求使用者聚合访问接口通过 ITableDefinitionWithConstraints::CreateTableWithConstraints 方法或 IOpenRowset::OpenRowset 方法显示的表值参数行集对象。使用者对象应只覆盖 IRowset 接口实现。您必须覆盖以下函数:

  • IRowset::GetNextRows

  • IRowset::AddRefRows

  • IRowset::GetData

  • IRowset::ReleaseRows

  • IRowset::RestartPosition

SQL Server Native Client OLE DB 访问接口将一次从使用者行集对象中读取一行或多行,以便在表值参数中支持流行为。例如,用户可能在磁盘上(而非内存中)具有表值参数行集数据,当 SQL Server Native Client OLE DB 访问接口要求时,可能实现从磁盘读取数据的功能。

使用者将通过对表值参数行集对象使用 IAccessor::CreateAccessor,将其数据格式传送给 SQL Server Native Client OLE DB 访问接口。当从使用者缓冲区读取数据时,访问接口将验证所有可写入和非默认列是否至少可用于一个取值函数句柄,并使用相应的句柄来读取列数据。为了避免混乱,在表值参数行集列与绑定之间应具有一对一的对应关系。与同一列的重复绑定将导致错误。此外,每个取值函数都应依次具有 DBBindings 的 iOrdinal 成员。对于 IRowset::GetData 的调用数将与每行的取值函数数量相同,调用的顺序将基于 iOrdinal 值的顺序(从低值到高值)。

访问接口应实现由表值参数行集对象显示的大多数接口。使用者将使用最少的接口实现行集对象 (IRowset)。由于盲聚合 (blind aggregation),因此,表值参数行集对象将实现剩下的所必需的行集对象接口。

对于任何其他行集对象(如对于任何 OLE DB 访问接口获得的行集对象),使用者提供的行集必须按照 OLE DB 规范要求实现所有必需的行集对象接口。

在执行时,SQL Server Native Client OLE DB 访问接口将回调行集对象以提取行并读取列数据。

请参阅

概念