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.