bcp_sendrow

  • 项目

适用于：SQL ServerAzure SQL 数据库Azure SQL 托管实例Azure Synapse AnalyticsAnalytics Platform System (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 时提交行。

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

另请参阅

大容量复制函数