bcp_batch
適用対象: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)
以前にプログラム変数から一括コピーされ、 bcp_sendrowによって SQL Server に送信されたすべての行をコミットします。
構文
DBINT bcp_batch (HDBC
hdbc);
引数
hdbc
一括コピーが有効な ODBC 接続ハンドルです。
返品
bcp_batchの最後の呼び出しの後に保存された行の数。エラーが発生した場合は -1。
解説
一括コピーのバッチではトランザクションを定義します。 アプリケーションが bcp_bind と bcp_sendrow を使用してプログラム変数から SQL Server テーブルに行を一括コピーする場合、プログラムが bcp_batch または bcp_doneを呼び出した場合にのみ、行がコミットされます。
bcp_batchは、n行ごとに 1 回、または受信データに小数があるとき (テレメトリ アプリケーションのように) 呼び出すことができます。 アプリケーションが bcp_batch 呼び出さない場合、一括コピーされた行は、 bcp_done が呼び出されたときにのみコミットされます。