分享方式：

bcp_collen

  • 文章

適用於：SQL Server Azure SQL 資料庫 Azure SQL 受控執行個體 Azure Synapse Analytics Analytics Platform System （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 一次。

另請參閱

大量複製函式