행 집합
적용 대상: 
SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)
행 집합은 데이터 열이 포함된 행의 집합입니다. 행 집합은 모든 OLE DB 데이터 공급자가 결과 집합 데이터를 테이블 형식으로 노출할 수 있도록 하는 중앙 개체입니다.
소비자가 IDBCreateSession::CreateSession 메서드를 사용하여 세션을 만든 후 소비자는 세션에서 IOpenRowset 또는 IDBCreateCommand 인터페이스를 사용하여 행 집합을 만들 수 있습니다. OLE DB Driver for SQL Server는 해당 인터페이스를 둘 다 지원합니다. 이러한 두 메서드는 모두 여기에 설명되어 있습니다.
IOpenRowset::OpenRowset 메서드를 호출하여 행 집합을 만듭니다.
이는 단일 테이블에 행 집합을 만드는 것과 같습니다. 이 메서드는 단일 기본 테이블의 모든 행을 포함하는 행 집합을 열고 반환합니다. OpenRowset에 대한 인수 중 하나는 행 집합을 만들 테이블을 식별하는 테이블 ID입니다.
IDBCreateCommand::CreateCommand 메서드를 호출하여 명령 개체를 만듭니다.
명령 개체는 공급자가 지원하는 명령을 실행합니다. 소비자는 OLE DB Driver for SQL Server를 사용하여 SELECT 문이나 저장 프로시저 호출과 같은 Transact-SQL 문을 지정할 수 있습니다. 명령 개체를 사용하여 행 집합을 만드는 단계는 다음과 같습니다.
소비자는 세션에서 IDBCreateCommand::CreateCommand 메서드를 호출하여 명령 개체를 가져오고 해당 명령 개체에서 ICommandText 인터페이스를 요청합니다. 이 ICommandText 인터페이스는 실제 명령 텍스트를 설정하고 검색합니다. 소비자는 ICommandText::SetCommandText 메서드를 호출하여 텍스트 명령을 채웁니다.
사용자가 명령에서 ICommand::Execute 메서드를 호출합니다. 명령을 실행할 때 작성된 행 집합 개체에는 명령의 결과 집합이 포함됩니다.
소비자는 ICommandProperties 인터페이스를 사용하여 ICommand::Execute 인터페이스에서 실행한 명령에서 반환된 행 집합의 속성을 얻거나 설정할 수 있습니다. 자주 요청되는 속성은 행 집합에서 지원해야 하는 인터페이스입니다. 소비자는 인터페이스 외에도 행 집합 또는 인터페이스의 동작을 수정하는 속성을 요청할 수 있습니다.
소비자는 IRowset::Release 메서드를 사용하여 행 집합을 해제 합니다. 행 집합을 해제하면 해당 행 집합에서 소비자가 보유한 행 핸들이 모두 해제됩니다. 행 집합을 해제해도 접근자가 해제되지는 않습니다. IAccessor 인터페이스가 있는 경우 계속 릴리스해야 합니다.