行集 (Native Client OLE DB 访问接口)
适用于:SQL Server Azure SQL 数据库 Azure SQL 托管实例 Azure Synapse Analytics Analytics 平台系统(PDW)
行集是一组包含数据列的行。 行集是使所有 OLE DB 数据访问接口能够以表格形式公开结果集数据的中心对象。
使用者使用 IDBCreateSession::CreateSession 方法创建会话之后,该使用者可以对会话使用 IOpenRowset 或 IDBCreateCommand 接口创建行集 。 SQL Server Native Client OLE DB 提供程序支持这两个接口。 下面描述这两种方法。
可调用 IOpenRowset::OpenRowset 方法来创建行集 。
这等同于通过单个表创建行集。 该方法打开并返回行集,其中包括单个基表中的所有行。 OpenRowset 的一个参数是表 ID,它标识从其创建该行集的表 。
可调用 IDBCreateCommand::CreateCommand 方法来创建命令对象 。
命令对象执行提供程序所支持的命令。 使用 SQL Server Native Client OLE DB 访问接口,使用者可以指定任何 Transact-SQL 语句,例如 SELECT 语句或对存储过程的调用。 使用命令对象创建行集的步骤如下:
使用者在会话中调用 IDBCreateCommand::CreateCommand 方法,以获得一个命令对象,并请求该命令对象的 ICommandText 接口 。 此 ICommandText 接口设置并检索实际的命令文本 。 使用者通过调用 ICommandText::SetCommandText 方法填充文本命令 。
用户调用该命令的 ICommand::Execute 方法 。 执行命令时生成的行集对象包含该命令产生的结果集。
使用者可以使用 ICommandProperties 接口获得或设置 ICommand::Execute 接口执行命令后返回的行集的属性 。 最经常请求的属性是行集必须支持的接口。 除了接口以外,使用者还可以请求能够修改行集或接口行为的属性。
使用者用 IRowset::Release 方法释放行集 。 释放行集时,将释放由该行集的使用者持有的任何行控点。 释放行集时,不会释放取值函数。 即使存在 IAccessor 接口,仍必须释放它 。