bcp_columns

适用于：SQL Server Azure SQL 数据库 Azure SQL 托管实例 Azure Synapse Analytics Analytics 平台系统（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 才能完全定义自定义文件格式。

另请参阅

大容量复制函数