IRowsetFastLoad:: Commit (Native Client OLE DB 공급자)

적용 대상: 예SQL Server(지원되는 모든 버전) 예Azure SQL Database 예Azure SQL Managed Instance 예Azure Synapse Analytics 예병렬 데이터 웨어하우스

일괄 삽입되는 행의 끝을 표시하고 행을 SQL Server 테이블에 씁니다. 샘플은 IRowsetFastLoad를 사용한 데이터 대량 복사(OLE DB)IROWSETFASTLOAD와 ISEQUENTIALSTREAM을 사용하여 SQL SERVER로 BLOB 데이터 전송(OLE DB)을 참조하세요.

구문

  
HRESULT Commit(  
      BOOL fDone);  

인수

fDone[in]
FALSE인 경우 행 집합은 계속 유효하며 소비자가 행을 추가로 삽입할 수 있습니다. TRUE인 경우 행 집합은 유효하지 않게 되며 소비자가 행을 추가로 삽입할 수 없습니다.

반환 코드 값

S_OK
메서드가 성공했으며 삽입한 모든 데이터가 SQL Server 테이블에 기록되었습니다.

E_FAIL
공급자 관련 오류가 발생했습니다. 오류 정보에서 공급자 관련 오류 텍스트를 검색하십시오.

E_UNEXPECTED
이전에 IRowsetFastLoad::Commit 메서드에 의해 무효화된 대량 복사 행 집합에서 메서드가 호출되었습니다.

설명

SQL ServerNative Client OLE DB 공급자 대량 복사 행 집합은 지연 업데이트 모드 행 집합으로 동작 합니다. 사용자가 행 집합을 통해 행 데이터를 삽입하면 삽입된 행은 IRowsetUpdate 를 지원하는 행 집합에서 보류 중인 삽입과 같은 방법으로 처리됩니다.

IRowsetUpdate::Update 메서드를 사용하여 보류 중인 행을 SQL Server 인스턴스로 전송하는 것과 같은 방법으로 소비자는 대량 복사 행 집합에 대해 Commit 메서드를 호출하여 삽입된 행을 SQL Server 테이블에 써야 합니다.

소비자가 Commit 메서드를 호출하지 않고 대량 복사 행 집합에 대한 참조를 해제하면 기존에 쓰지 않은 삽입된 행이 모두 손실됩니다.

소비자는 fDone 인수를 FALSE로 설정하고 Commit 메서드를 호출하여 삽입된 행을 일괄 처리할 수 있습니다. fDone 을 TRUE로 설정하면 행 집합이 무효화됩니다. 무효화된 대량 복사 행 집합에는 ISupportErrorInfo 인터페이스 및 IRowsetFastLoad::Release 메서드만 지원됩니다.

참고 항목

IRowsetFastLoad (OLE DB)