bcp_columns
適用対象: 
SQL Server Azure SQL データベース Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)
SQL Server との間の一括コピーで使用するユーザー ファイル内の列の合計数を設定します。 bcp_setbulkmode は、bcp_columnsと bcp_colfmtの代わりに使用できます。
構文
RETCODE bcp_columns (
HDBC hdbc,
INT nColumns);
引数
hdbc
一括コピーが有効な ODBC 接続ハンドルです。
nColumns
ユーザー ファイル内の合計列数です。 ユーザー ファイルから SQL Server テーブルにデータを一括コピーする準備をしていて、ユーザー ファイル内のすべての列をコピーしない場合でも、 nColumns ユーザー ファイルの列の合計数を設定する必要があります。
返品
SUCCEED または FAIL。
解説
この関数は、有効なファイル名 bcp_init 呼び出された後にのみ呼び出すことができます。
この関数を呼び出す必要があるのは、既定とは異なる形式のユーザー ファイルを使用する場合のみです。 既定のユーザー ファイル形式の説明の詳細については、 bcp_initを参照してください。
bcp_columnsを呼び出した後、ユーザー ファイル内の各列のbcp_colfmtを呼び出して、カスタム ファイル形式を完全に定義する必要があります。