bcp_collen
適用対象: 
SQL Server Azure SQL データベース 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 回呼び出す必要があります。