bcp_columns

  • [アーティクル]

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

参照

一括コピー関数