IRowsetFastLoad::Commit (OLE DB)

Platí na:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytický platformový systém (PDW)SQL databáze v Microsoft Fabric

Stáhnout ovladač OLE DB

Označí konec série vložených řádků a zapíše řádky do tabulky SQL Serveru. Pro ukázky viz Hromadné kopírovaní dat pomocí IRowsetFastLoad (OLE DB) a Odeslání BLOB dat do SQL SERVERU pomocí IROWSETFASTLOAD a ISEQUENTIALSTREAM (OLE DB).

Syntaxe

  
HRESULT Commit(  
      BOOL fDone);  

Arguments

fDone[in]
Pokud je FALSE, řádková sada si zachovává platnost a může být uživatelem použita pro další vkládání řádků. Pokud je PRAVDA, řádky ztrácejí platnost a uživatel už nemůže další vkládání provést.

Návratové hodnoty kódu

S_OK
Metoda byla úspěšná a všechna vložená data byla zapsána do tabulky SQL Serveru.

E_FAIL
Došlo k chybě specifické pro poskytovatele. Získejte informace o chybě konkrétního textu chyby od poskytovatele.

E_UNEXPECTED
Metoda byla volána na hromadné kopii řádků, které byly dříve zneplatněny metodou IRowsetFastLoad::Commit .

Poznámky

Ovladač OLE DB pro hromadnou kopii řádků SQL Serveru se chová jako řadová sada v režimu zpožděné aktualizace. Když uživatel vkládá data řádků skrz sadu řádků, vložené řádky jsou zpracovávány stejným způsobem jako čekající vkládání v sadě řádků podporující IRowsetUpdate.

Spotřebitel musí volat metodu Commit na hromadné kopii řádků, aby zapsal vložené řádky do tabulky SQL Serveru stejným způsobem, jakým se metoda IRowsetUpdate::Update používá k odesílání čekajících řádků do instance SQL Serveru.

Pokud uživatel uvolní svou referenci na hromadné kopii řádků bez volání metody Commit , všechny vložené řádky, které nebyly dříve zapsány, jsou ztraceny.

Spotřebitel může dávkově vkládat řádky voláním metody Commit s argumentem fDone nastaveným na FALSE. Když je fDone nastavenona TRUE, řádková sada se stává neplatnou. Neplatná hromadná kopie řádků podporuje pouze rozhraní ISupportErrorInfo a metodu IRowsetFastLoad::Release .

Viz také

IRowsetFastLoad (OLE DB)