IMultipleResults를 사용하여 여러 결과 집합 처리
소비자는 SQL Server Native Client OLE DB 공급자 명령 실행으로 반환된 결과를 처리하기 위해 IMultipleResults 인터페이스를 사용할 수 있습니다. SQL Server Native Client OLE DB 공급자가 실행 명령을 보내면 SQL Server는 해당 문을 실행하고 결과를 반환합니다.
클라이언트는 명령 실행을 통해 반환된 모든 결과를 처리해야 합니다. SQL Server Native Client OLE DB 공급자 명령 실행의 결과로 여러 행 집합 개체가 생성될 수 있으므로 응용 프로그램 데이터 검색 작업에서 클라이언트가 시작한 왕복을 완료할 수 있도록 하려면 IMultipleResults 인터페이스를 사용해야 합니다.
다음 Transact-SQL 문은 여러 행 집합을 생성합니다. 이 중에는 OrderDetails 테이블의 행 데이터 집합도 있고, COMPUTE BY 절의 결과 집합도 있습니다.
SELECT OrderID, FullPrice = (UnitPrice * Quantity), Discount,
Discounted = UnitPrice * (1 - Discount) * Quantity
FROM OrderDetails
ORDER BY OrderID
COMPUTE
SUM(UnitPrice * Quantity), SUM(UnitPrice * (1 - Discount) * Quantity)
BY OrderID
소비자가 이 텍스트를 포함하는 명령을 실행하고 반환되는 결과 인터페이스로 행 집합을 요청하면 첫 번째 행 집합만 반환됩니다. 이 경우 소비자는 반환되는 행 집합에 있는 모든 행을 처리할 수 있습니다. 그러나 DBPROP_MULTIPLECONNECTIONS 데이터 원본 속성이 VARIANT_FALSE로 설정되어 있고 연결에 MARS가 설정되어 있지 않은 경우 명령이 취소되기 전까지 해당 세션 개체에 대해 다른 명령을 실행할 수 없으며 SQL Server Native Client OLE DB 공급자는 다른 연결을 만들지 않습니다. 연결에 MARS가 설정되어 있지 않은 경우 SQL Server Native Client OLE DB 공급자는 DBPROP_MULTIPLECONNECTIONS가 VARIANT_FALSE이면 DB_E_OBJECTOPEN 오류를 반환하고, 활성 트랜잭션이 있으면 E_FAIL을 반환합니다.
또한 SQL Server Native Client OLE DB 공급자는 스트림된 출력 매개 변수를 사용할 때 다음 결과 집합을 얻기 위해 IMultipleResults::GetResults를 호출하기 전에 응용 프로그램에서 반환된 출력 매개 변수 값을 모두 사용하지 않은 경우에도 DB_E_OBJECTOPEN을 반환합니다. MARS가 설정되어 있지 않은 상태에서 연결이 행 집합을 생성하지 않는 명령 또는 서버 커서가 아닌 행 집합을 생성하는 명령을 실행 중이고 DBPROP_MULTIPLECONNECTIONS 데이터 원본 속성이 VARIANT_TRUE로 설정되어 있는 경우, 트랜잭션이 오류를 반환하는 활성 상태가 아니면 SQL Server Native Client OLE DB 공급자가 동시 명령 개체를 지원하기 위해 추가 연결을 만듭니다. 트랜잭션 및 잠금은 SQL Server가 연결별로 관리합니다. 두 번째 연결이 생성되면 개별 연결의 명령이 잠금을 공유하지 않습니다. 한 명령이 다른 명령을 차단하지 않도록 다른 명령이 요청한 행의 잠금이 유지되도록 주의해야 합니다. MARS가 설정되어 있는 경우 연결에 여러 명령을 활성화할 수 있으며 명시적 트랜잭션이 사용 중인 경우 모든 명령이 공통 트랜잭션을 공유합니다.
소비자는 ISSAbort::Abort를 사용하거나 명령 개체 및 파생 행 집합에서 유지하는 모든 참조를 해제하는 방식으로 명령을 취소합니다.
소비자는 모든 인스턴스에서 IMultipleResults를 사용하여 명령 실행을 통해 생성된 모든 행 집합을 얻을 수 있으며, 명령 실행을 취소하여 다른 명령에서 사용할 수 있도록 세션 개체를 해제할 적절한 시점을 결정할 수 있습니다.
[!참고]
SQL Server 커서를 사용할 때 명령을 실행하면 커서가 생성됩니다. SQL Server는 커서 생성에 대한 성공이나 실패를 반환하므로 SQL Server 인스턴스에 대한 왕복은 명령 실행 결과가 반환되면 완료됩니다. GetNextRows를 호출할 때마다 왕복이 수행됩니다. 따라서 여러 활성 명령 개체가 존재할 수 있으며, 이러한 각각의 개체가 서버 커서에서 인출한 결과 행 집합을 처리할 수 있습니다. 자세한 내용은 행 집합 및 SQL Server 커서를 참조하십시오.