bcp_columns

  • 项目

适用于：SQL ServerAzure SQL 数据库Azure SQL 托管实例Azure 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 ，以完全定义自定义文件格式。

另请参阅

大容量复制函数