bcp_columns

適用対象: SQL Server Azure SQL Database 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を呼び出して、カスタム ファイル形式を完全に定義する必要があります。

参照

一括コピー関数