IRowsetFastLoad::Commit (provider OLE DB di Native Client)

Si applica a:SQL ServerDatabase SQL diAzure Istanzagestita di SQL di Azure Azure Synapse Analytics PlatformSystem (PDW)

Importante

SQL Server Native Client (spesso abbreviato SNAC) è stato rimosso da SQL Server 2022 (16.x) e SQL Server Management Studio 19 (SSMS). Non è consigliabile usare sia il provider OLE DB SQL Server Native Client (SQLNCLI o SQLNCLI11) che il provider Microsoft OLE DB legacy per SQL Server (SQLOLEDB). Passare al nuovo Microsoft OLE DB Driver (MSOLEDBSQL) per SQL Server in futuro.

Contrassegna la fine di un batch di righe inserite e scrive le righe nella tabella di SQL Server. Per gli esempi, vedere Eseguire una copia bulk dei dati usando IRowsetFastLoad (OLE DB) e Inviare dati BLOB a SQL Server usando IROWSETFASTLOAD e ISEQUENTIALSTREAM (OLE DB).

Sintassi

  
HRESULT Commit(  
      BOOL fDone);  

Argomenti

fDone[in]
Se impostato su FALSE, il set di righe resta valido e può essere utilizzato dal consumer per l'inserimento di altre righe. Se impostato su TRUE, il set di righe non è più valido e il consumer non può inserire altre righe.

Valori del codice restituito

S_OK
Il metodo è riuscito e tutti i dati inseriti sono stati scritti nella tabella SQL Server.

E_FAIL
Si è verificato un errore specifico del provider. Recuperare informazioni relative al testo dell'errore specifico dal provider.

E_UNEXPECTED
Il metodo è stato chiamato su un set di righe della copia bulk precedentemente invalidato dal metodo IRowsetFastLoad::Commit.

Osservazioni:

Un set di righe di copia bulk del provider OLE DB di SQL Server Native Client si comporta come set di righe in modalità aggiornamento ritardato. Quando l'utente inserisce dati di riga nel set di righe, le righe inserite vengono gestite analogamente agli inserimenti in sospeso di un set di righe che supporta IRowsetUpdate.

Il consumer deve chiamare il metodo Commit sul set di righe della copia bulk per scrivere le righe inserite nella tabella SQL Server esattamente come quando si usa il metodo IRowsetUpdate::Update per inviare le righe in sospeso a un'istanza di SQL Server.

Se il consumer rilascia il riferimento al set di righe della copia bulk senza chiamare il metodo Commit, tutte le righe inserite e non scritte in precedenza andranno perse.

Il consumer può raggruppare le righe inserite chiamando il metodo Commit con l'argomento fDone impostato su FALSE. Quando fDone è impostato su TRUE, il set di righe non è più valido. Un set di righe della copia bulk non valido supporta solo l'interfaccia ISupportErrorInfo e il metodo IRowsetFastLoad::Release.

Vedi anche

IRowsetFastLoad (OLE DB)