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 一次。