Share via

bcp_collen

  • 项目

适用于：SQL ServerAzure SQL 数据库Azure SQL 托管实例Azure Synapse AnalyticsAnalytics Platform System (PDW)

将当前大容量复制的程序变量中的数据长度设置为 SQL Server。

语法

  
RETCODE bcp_collen (  
        HDBC hdbc,  
        DBINT cbData,  
        INT idxServerCol);

参数

hdbc
已启用大容量复制的 ODBC 连接句柄。

cbData
程序变量中数据的长度，不包括任何长度指示器或终止符的长度。 将 cbData 设置为 SQL_NULL_DATA 表示复制到服务器的所有行都包含列的 NULL 值。 设置为 SQL_VARLEN_DATA 则指示使用字符串终止符或其他方法确定复制的数据的长度。 如果同时提供长度指示器和终止符，系统将使用二者中复制数据量较少的一个。

idxServerCol
数据复制到的表中的列的序号位置。 第一列为 1。 列的序号位置由 SQLColumns 报告。

返回

SUCCEED 或 FAIL。

备注

使用 bcp_collen 函数，可以在使用 bcp_sendrow 将数据复制到SQL Server时，更改特定列的程序变量中的数据长度。

最初，数据长度是在调用 bcp_bind 时确定的。 如果在调用 bcp_sendrow 之间数据长度发生更改，并且未使用长度前缀或终止符，则可以调用 bcp_collen 来重置长度。 下一次调用 bcp_sendrow 使用调用 bcp_collen设置的长度。

对于要修改其数据长度的表中的每个列，必须调用 一次bcp_collen 。

另请参阅

大容量复制函数