次の方法で共有

bcp_collen

  • [アーティクル]

適用対象: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

SQL Server への現在の一括コピーのプログラム変数のデータ長を設定します。

構文

  
RETCODE bcp_collen (  
        HDBC hdbc,  
        DBINT cbData,  
        INT idxServerCol);

引数

hdbc
一括コピーが有効な ODBC 接続ハンドルです。

cbData
プログラム変数内のデータ長です。長さのインジケーターやターミネータの長さは含まれません。 cbData を SQL_NULL_DATA に設定すると、サーバーにコピーされたすべての行に列の NULL 値が含まれていることが示されます。 また、SQL_VARLEN_DATA に設定すると、文字列ターミネータや他の方法を使用してコピーするデータ長が決定されます。 長さのインジケーターとターミネータの両方を指定した場合、システムはコピーするデータ量が少なくなる方法を使用します。

idxServerCol
テーブル内にある、データのコピー先となる列の序数位置です。 最初の列は 1 です。 列の序数位置は、 SQLColumns によって報告されます。

返品

SUCCEED または FAIL。

解説

bcp_collen関数を使用すると、bcp_sendrowを使用して SQL Server にデータをコピーするときに、特定の列のプログラム変数のデータ長を変更できます。

最初に、データの長さは、 bcp_bind が呼び出されたときに決定されます。 bcp_sendrowの呼び出しの間でデータ長が変化し、長さのプレフィックスまたはターミネータが使用されていない場合は、bcp_collenを呼び出して長さをリセットできます。 bcp_sendrowへの次の呼び出しでは、bcp_collenの呼び出しによって設定された長さが使用されます。

データの長さを変更するテーブル内の列ごとに、 bcp_collen を 1 回呼び出す必要があります。

参照

一括コピー関数