IRowsetFastLoad::Commit (OLE DB)

Vonatkozik a következőkre:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalitikai Platform System (PDW)SQL adatbázis a Microsoft Fabric-ben

OLE DB-illesztő letöltése

Megjelöli a beillesztett sorok végét, és a sorokat az SQL Server táblába írja meg. A mintákért lásd: Bulk Copy Data Using IRowsetFastLoad (OLE DB) és Send BLOB Data to SQL SERVER Using IROWSETFASTLOAD és ISEQUENTIALSTREAM (OLE DB).

Szemantika

  
HRESULT Commit(  
      BOOL fDone);  

Arguments

fDone[in]
Ha HAMIS, a sorhalmaz érvényes marad, és a fogyasztó további sorbehelyezésre használhatja. Ha TRUE, a sorhalmaz elveszíti az érvényességet, és a fogyasztó nem tud további beillesztést.

Kódértékek visszaadása

S_OK
A módszer sikeres volt, és minden beillesztett adat az SQL Server táblába került.

E_FAIL
Szolgáltató-specifikus hiba történt. Kérd le a szolgáltatótól a konkrét hibaszöveg hibainformációját.

E_UNEXPECTED
A metódusot egy tömeges másolási sorhalmazon hívták meg, amelyet korábban az IRowsetFastLoad::Commit metódus érvénytelenített.

Megjegyzések

Az SQL Server tömeges másolat sorkészletéhez készült OLE DB driver késleltetett frissítési módú sorkészletként viselkedik. Amikor a felhasználó soradatokat illeszt be a sorhalmazon keresztül, a beillesztett sorokat ugyanúgy kezelik, mint a várakozó beillesztéseket egy IRowsetUpdate-et támogató sorhalmazon.

A felhasználónak a Commit metóduzót kell hívnia a tömeges másolás sorhalmazán, hogy beillesztett sorokat írjon az SQL Server táblájába, ugyanúgy, ahogy az IRowsetUpdate::Update módszert használják a függő sorok benyújtására egy SQL Server példányának.

Ha a felhasználó a hivatkozást a tömeges másolási sorhalmazon anélkül adja ki, hogy a Commit metódust hívja, akkor minden korábban nem írt beillesztett sor elveszik.

A fogyasztó a Commit metódus hívásával kötött sorokat használhat, ha az fDone argumentumot FALSE-ra állítva hívja. Ha az fDoneTRUE-ra van állítva, a sorhalmaz érvénytelenné válik. Egy érvénytelen tömeges másolás sorkészlet csak az ISupportErrorInfo interfészt és az IRowsetFastLoad::Release módszert támogatja.

Lásd még:

IRowsetFastLoad (OLE DB)