bcp_collen

适用于:SQL Server Azure SQL 数据库 Azure SQL 托管实例 Azure Synapse Analytics Analytics 平台系统(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 一次。

另请参阅

大容量复制函数