bcp_sendrow
適用対象:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)
プログラム変数からSQL Serverにデータの行を送信します。
構文
RETCODE bcp_sendrow (
HDBC hdbc);
引数
hdbc
一括コピーが有効な ODBC 接続ハンドルです。
戻り値
SUCCEED または FAIL。
解説
bcp_sendrow関数は、プログラム変数から行をビルドし、SQL Serverに送信します。
bcp_sendrowを呼び出す前に、bcp_bindを呼び出して、行データを含むプログラム変数を指定する必要があります。
長い可変長データ型 (SQLTEXT の eDataType パラメーターや NULL 以外の pData パラメーターなど) を指定するbcp_bindが呼び出bcp_sendrow、他のデータ型の場合と同様に、データ値全体が送信されます。 ただし、bcp_bindに NULL pData パラメーターがある場合、bcp_sendrowは、指定されたデータを持つすべての列がSQL Serverに送信された直後に、アプリケーションに制御を返します。 その後、アプリケーションは bcp_moretext を繰り返し呼び出して、長い可変長データを一度にチャンクSQL Serverに送信できます。 詳細については、「 bcp_moretext」を参照してください。
bcp_sendrowを使用してプログラム変数からSQL Server テーブルに行を一括コピーする場合、ユーザーが bcp_batch または bcp_doneを呼び出した場合にのみ行がコミットされます。 ユーザーは、n 行ごとに 1 回bcp_batchを呼び出すか、受信データの期間の間に小さなデータがある場合に呼び出すことができます。 bcp_batchが呼び出されない場合、bcp_doneが呼び出されたときに行がコミットされます。
SQL Server 2005 (9.x) 以降の一括コピーの破壊的変更については、「一括コピー操作の実行 (ODBC)」を参照してください。
参照
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示