bcp_batch

Gilt für: SQL Server Azure SQL-Datenbank Azure SQL verwaltete Instanz Azure Synapse Analytics Analytics Platform System (PDW)

Commits aller Zeilen, die zuvor aus Programmvariablen kopiert wurden und von bcp_sendrow an SQL Server gesendet wurden.

Syntax

  
DBINT bcp_batch (HDBC  
        hdbc);  

Argumente

hdbc
Das für den Massenkopiervorgang aktivierte ODBC-Verbindungshandle.

Gibt zurück

Die Anzahl von Zeilen, die nach dem letzten Aufruf von bcp_batchgespeichert wurden, oder -1 im Fall eines Fehlers.

Hinweise

Batches von Massenkopiervorgängen stellen Transaktionen dar. Wenn eine Anwendung mit bcp_bind und bcp_sendrow Zeilen von Programmvariablen in SQL-Server-Tabellen massenkopiert, wird für die Zeilen nur dann ein Commit durchgeführt, wenn das Programm bcp_batch oder bcp_doneaufruft.

Sie können bcp_batch einmal für jede n Zeilen aufrufen oder dann, wenn bei den eingehenden Daten eine Pause auftritt (wie in einer Telemetrieanwendung). Wenn eine Anwendung bcp_batch nicht aufruft, wird nur dann ein Commit für die massenkopierten Zeilen ausgeführt, wenn bcp_done aufgerufen wird.

Weitere Informationen

Massenkopierfunktionen