分享方式:


bcp_sendrow

適用於:SQL Server Azure SQL 資料庫 Azure SQL 受控執行個體 Azure Synapse Analytics Analytics Platform System (PDW)

將數據列從程式變數傳送至 SQL Server。

語法

  
RETCODE bcp_sendrow (  
    HDBC hdbc);  

引數

hdbc
這是啟用大量複製的 ODBC 連接句柄。

傳回

SUCCEED 或FAIL。

備註

bcp_sendrow函 會從程式變數建置數據列,並將其傳送至 SQL Server。

呼叫 bcp_sendrow之前,您必須呼叫 bcp_bind ,以指定包含數據列數據的程式變數。

如果 呼叫 bcp_bind指定long、variable-length數據類型,例如 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)

另請參閱

大量複製函式