資料列集 (Native Client OLE DB 提供者)
適用於: SQL Server Azure SQL 資料庫 Azure SQL 受控執行個體 Azure Synapse Analytics Analytics Platform System (PDW)
資料列集是一組資料列,其中包含資料的資料行。 資料列集是能讓所有 OLE DB 資料提供者公開表格形式結果集資料的核心物件。
取用者使用 IDBCreateSession::CreateSession 方法建立工作階段之後,就可以使用工作階段上的 IOpenRowset 或 IDBCreateCommand 介面建立資料列集。 SQL Server Native Client OLE DB 提供者支援這兩個介面。 此處描述這兩種方法。
呼叫 IOpenRowset::OpenRowset 方法來建立資料列集。
這相當於在單一資料表上建立資料列集。 此方法會從單一基底資料表開啟並傳回包含所有資料列的資料列集。 其中的 OpenRowset 引數是資料表識別碼,可識別要從中建立資料列集的資料表。
呼叫 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 介面,仍然必須釋放該介面。