创建表值参数行集

适用于:SQL Server Azure SQL 数据库 Azure SQL 托管实例 Azure Synapse Analytics Analytics 平台系统(PDW)

下载 OLE DB 驱动程序

尽管使用者可以为表值参数提供任意行集对象,但是典型的行集对象要针对后端数据存储来实现,因此提供有限的性能。 因此,适用于 SQL Server 的 OLE DB 驱动程序支持使用者基于内存中的数据创建专用的行集对象。 这种特殊的内存中的行集对象是一种新的 COM 对象,称为表值参数行集。 它提供与参数集相似的功能。

表值参数行集对象由使用者通过多个会话级接口为输入参数显式创建。 每个表值参数对应一个表值参数行集对象实例。 使用者可以通过以下两种方法之一创建表值参数行集对象:提供已知的元数据信息(静态方案);或者通过访问接口发现元数据信息(动态方案)。 以下各节介绍这两种方案。

静态方案

如果类型信息已知,使用者使用 ITableDefinitionWithConstraints::CreateTableWithConstraints 对与表值参数对应的表值参数行集对象进行实例化。

guid 字段(pTableID 参数)包含特殊 GUID (CLSID_ROWSET_TVP)。 pwszName 成员包含使用者要实例化的表值参数类型的名称 。 eKind 字段将设置为 DBKIND_GUID_NAME 。 使用特殊 SQL 语句时此名称是必需时,使用过程调用时可选。

对于聚合,使用者传递 pUnkOuter 参数(带有控制的 IUnknown)。

表值参数行集对象属性只读,因此使用者无需在 rgPropertySets 中设置任何属性 。

对于每个 DBCOLUMNDESC 结构中的 rgPropertySets 成员,使用者可为每列指定附加属性 。 这些属性属于 DBPROPSET_SQLSERVERCOLUMN 属性集。 它们支持您为每一列指定计算设置和默认设置。 它们还支持现有列属性,如为空性和标识。

要从表值参数行集对象中检索相应的信息,使用者应使用 IRowsetInfo::GetProperties。

若要检索有关每个列的 null、唯一、计算和更新状态的信息,使用者可以使用 IColumnsRowset::GetColumnsRowset 或 IColumnsInfo::GetColumnInfo。 以下方法提供有关每个表值参数行集列的详细信息。

使用者指定表值参数每一列的类型。 这类似于在 SQL Server 中创建表时指定列的方式。 使用者通过 ppRowset 输出参数从 OLE DB Driver for SQL Server 获取表值参数行集对象。

动态方案

如果使用者不具有类型信息,它应该使用 IOpenRowset::OpenRowset 对表值参数行集对象实例化。 使用者只需向访问接口提供类型名称。

在此方案中,访问接口代表使用者从服务器获取有关表值参数行集对象的类型信息。

应按照静态方案的设置对 pTableID 和 pUnkOuter 参数进行设置。 然后,适用于 SQL Server 的 OLE DB 驱动程序从服务器中获取类型信息(列信息和约束),并通过 ppRowset 参数返回表值参数行集对象 。 此操作要求与服务器通信,因此性能不如静态方案。 动态方案仅适用于参数化过程调用。

另请参阅

表值参数 (OLE DB)
使用表值参数 (OLE DB)