bcp_sendrow

适用于:SQL Server Azure SQL 数据库 Azure SQL 托管实例 Azure Synapse Analytics Analytics 平台系统(PDW)

将一行数据从程序变量发送到 SQL Server。

语法

  
RETCODE bcp_sendrow (  
    HDBC hdbc);  

参数

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

返回

SUCCEED 或 FAIL。

注解

bcp_sendrow函数从程序变量生成一行,并将其发送到 SQL Server。

在调用 bcp_sendrow之前,必须调用 bcp_bind 以指定包含行数据的程序变量。

如果 调用bcp_bind 指定长、可变长度的数据类型,例如 SQLTEXT 的 eDataType 参数和非 NULL pData 参数, bcp_sendrow 发送整个数据值,就像对任何其他数据类型一样。 但是, 如果bcp_bind 具有 NULL pData 参数, 则bcp_sendrow 在指定数据的所有列都发送到 SQL Server 后立即向应用程序返回控件。 然后,应用程序可以重复调用 bcp_moretext ,以将长长度可变的数据一次发送到 SQL Server(一个区块)。 有关详细信息,请参阅 bcp_moretext

使用 bcp_sendrow 将程序变量中的行批量复制到 SQL Server 表中时,仅当用户调用 bcp_batchbcp_done时才会提交行。 用户可以选择n 行调用一次bcp_batch,或者在传入数据的时间段之间出现空位时。 如果从未调用bcp_batch,则会在调用bcp_done提交行。

有关从 SQL Server 2005(9.x)开始的大容量复制中断性变更的信息,请参阅执行大容量复制操作(ODBC)。

另请参阅

大容量复制函数