次の方法で共有

bcp_sendrow

  • [アーティクル]

適用対象: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics 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 パラメーターがある場合、指定されたすべての列が SQL Server に送信された直後に、 bcp_sendrow は制御をアプリケーションに返します。 その後、アプリケーションは bcp_moretext を繰り返し呼び出して、長い可変長データを一度に 1 つのチャンクである 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)」を参照してください。

参照

一括コピー関数