IRowsetFastLoad:: Commit (proveedor de OLE DB de Native Client)IRowsetFastLoad::Commit (Native Client OLE DB Provider)

Se aplica a:Applies to: síSQL ServerSQL Server (todas las versiones admitidas) yesSQL ServerSQL Server (all supported versions) SíAzure SQL DatabaseAzure SQL DatabaseYesAzure SQL DatabaseAzure SQL Database SíInstancia administrada de Azure SQLAzure SQL Managed InstanceYesInstancia administrada de Azure SQLAzure SQL Managed Instance síAzure Synapse AnalyticsAzure Synapse AnalyticsyesAzure Synapse AnalyticsAzure Synapse Analytics síAlmacenamiento de datos paralelosParallel Data WarehouseyesAlmacenamiento de datos paralelosParallel Data WarehouseSe aplica a:Applies to: síSQL ServerSQL Server (todas las versiones admitidas) yesSQL ServerSQL Server (all supported versions) SíAzure SQL DatabaseAzure SQL DatabaseYesAzure SQL DatabaseAzure SQL Database SíInstancia administrada de Azure SQLAzure SQL Managed InstanceYesInstancia administrada de Azure SQLAzure SQL Managed Instance síAzure Synapse AnalyticsAzure Synapse AnalyticsyesAzure Synapse AnalyticsAzure Synapse Analytics síAlmacenamiento de datos paralelosParallel Data WarehouseyesAlmacenamiento de datos paralelosParallel Data Warehouse

Marca el final de un lote de filas insertadas y escribe las filas en la tabla SQL ServerSQL Server .Marks the end of a batch of inserted rows and writes the rows to the SQL ServerSQL Server table. Para ver ejemplos, consulte Copiar datos de forma masiva mediante IRowsetFastLoad (OLE DB) y Enviar datos BLOB a SQL SERVER mediante IROWSETFASTLOAD e ISEQUENTIALSTREAM (OLE DB).For samples, see Bulk Copy Data Using IRowsetFastLoad (OLE DB) and Send BLOB Data to SQL SERVER Using IROWSETFASTLOAD and ISEQUENTIALSTREAM (OLE DB).

SintaxisSyntax

  
HRESULT Commit(  
      BOOL fDone);  

ArgumentosArguments

fDone[in]fDone[in]
Si es FALSE, el conjunto de filas mantiene la validez y el consumidor puede usarlo para una inserción de filas adicional.If FALSE, the rowset maintains validity and can be used by the consumer for additional row insertion. Si es TRUE, el conjunto de filas pierde su validez y el consumidor no puede realizar ninguna inserción más.If TRUE, the rowset loses validity and no further insertion can be done by the consumer.

Valores de código de retornoReturn Code Values

S_OKS_OK
El método se ejecutó correctamente y todos los datos insertados se escribieron en la tabla SQL ServerSQL Server.The method succeeded and all inserted data has been written to the SQL ServerSQL Server table.

E_FAILE_FAIL
Se produjo un error específico del proveedor.A provider-specific error occurred. Recupere la información de error para el texto de error específico del proveedor.Retrieve error information for the specific error text from the provider.

E_UNEXPECTEDE_UNEXPECTED
Se ha llamado al método en un conjunto de filas de copia masiva previamente invalidado por el método IRowsetFastLoad::Commit.The method was called on a bulk copy rowset previously invalidated by the IRowsetFastLoad::Commit method.

ObservacionesRemarks

Un SQL ServerSQL Server conjunto de filas de copia masiva del proveedor de OLE DB de Native Client se comporta como un conjunto de filas del modo de actualización retrasada.A SQL ServerSQL Server Native Client OLE DB provider bulk copy rowset behaves as a delayed-update mode rowset. A medida que el usuario inserta los datos de fila a través del conjunto de filas, las filas insertadas reciben el mismo trato que las inserciones pendientes en un conjunto de filas que admite IRowsetUpdate.As the user inserts row data through the rowset, inserted rows are treated in the same fashion as pending inserts on a rowset supporting IRowsetUpdate.

El consumidor debe llamar al método Commit en el conjunto de filas de copia masiva para escribir las filas insertadas en la tabla de SQL ServerSQL Server del mismo modo en que se usa el método IRowsetUpdate::Update para enviar las filas pendientes a una instancia de SQL Server.The consumer must call the Commit method on the bulk copy rowset to write inserted rows to the SQL ServerSQL Server table in the same way as the IRowsetUpdate::Update method is used to submit pending rows to an instance of SQL Server.

Si el consumidor libera su referencia en el conjunto de filas de copia masiva sin llamar al método Commit, se perderán todas las filas insertadas que no se hayan escrito previamente.If the consumer releases its reference on the bulk copy rowset without calling the Commit method, all inserted rows not previously written are lost.

El consumidor puede procesar por lotes las filas insertadas mediante una llamada al método Commit con el argumento fDone establecido en FALSE.The consumer can batch inserted rows by calling the Commit method with the fDone argument set to FALSE. Cuando fDone se establece en TRUE, el conjunto de filas deja de ser válido.When fDone is set to TRUE, the rowset becomes invalid. Un conjunto de filas de copia masiva que no es válido solo admite la interfaz ISupportErrorInfo y el método IRowsetFastLoad::Release.An invalid bulk copy rowset supports only the ISupportErrorInfo interface and IRowsetFastLoad::Release method.

Consulte tambiénSee Also

IRowsetFastLoad (OLE DB)IRowsetFastLoad (OLE DB)