プログラム変数から SQL Server にデータ行を送信します。
構文
RETCODE bcp_sendrow (
HDBC hdbc);
引数
- hdbc
一括コピーが有効な ODBC 接続ハンドルです。
戻り値
SUCCEED または FAIL を返します。
解説
bcp_sendrow 関数は、プログラム変数から行をビルドし、SQL Server に送信します。
bcp_sendrow を呼び出す前に、bcp_bind を呼び出して、行データを含むプログラム変数を指定する必要があります。
eDataType パラメータに SQLTEXT を指定したり、pData パラメータに NULL 以外の値を指定することで、長い可変長データ型を指定して bcp_bind を呼び出すと、bcp_sendrow では他のデータ型の場合と同様に、データ値全体が送信されます。ただし、pData パラメータに NULL を指定して bcp_bind を呼び出すと、bcp_sendrow は、指定されたデータを含むすべての列を SQL Server に送信した直後にアプリケーションに制御を戻します。その後、アプリケーションでは bcp_moretext を繰り返し呼び出して、長い可変長のデータをチャンク単位に SQL Server に送信します。詳細については、「bcp_moretext」を参照してください。
bcp_sendrow を使用してプログラム変数から SQL Server テーブルに行を一括コピーする場合、行がコミットされるのは、ユーザーが bcp_batch または bcp_done を呼び出したときだけです。ユーザーは、bcp_batch を n 行ごとに 1 回呼び出すか、データが着信してから次に着信するまでに一時的なアイドル状態があるときに呼び出すことを選択できます。bcp_batch を呼び出さない場合は、bcp_done を呼び出したときに行がコミットされます。