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_batch 或 bcp_done时才会提交行。 用户可以选择每 n 行调用一次bcp_batch,或者在传入数据的时间段之间出现空位时。 如果从未调用bcp_batch,则会在调用bcp_done时提交行。
有关从 SQL Server 2005(9.x)开始的大容量复制中断性变更的信息,请参阅执行大容量复制操作(ODBC)。