bcp_batch

適用対象:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics 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 が呼び出されたときにのみコミットされます。

参照

一括コピー関数