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 才能完全定义自定义文件格式。

另请参阅

大容量复制函数