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.