bcp_collen

gäller för:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics

Sätter datalängden i programvariabeln för den aktuella bulkkopian i SQL Server.

Syntax

  
RETCODE bcp_collen (  
        HDBC hdbc,  
        DBINT cbData,  
        INT idxServerCol);  

Arguments

hdbc
Är den masskopieringsaktiverade ODBC-anslutningshandtaget.

cbData
Är längden på datan i programvariabeln, exklusive längden på någon längdindikator eller terminator. Att sätta cbData till SQL_NULL_DATA indikerar att alla rader som kopieras till servern innehåller ett NULL-värde för kolumnen. Att ställa in den till SQL_VARLEN_DATA indikerar att en strängterminator eller annan metod används för att bestämma längden på den kopierade datan. Om både en längdindikator och en terminator finns, använder systemet den som resulterar i att mindre data kopieras.

idxServerCol
Är den ordinala positionen för kolumnen i tabellen till vilken datan kopieras. Den första kolumnen är 1. Kolumnens ordinala position rapporteras av SQLColumns.

Returns

SUCCEED eller FAIL.

Remarks

Funktionen bcp_collen låter dig ändra datalängden i programvariabeln för en viss kolumn när du kopierar data till SQL Server med bcp_sendrow.

Inledningsvis bestäms datans längd när bcp_bind anropas. Om datalängden ändras mellan anrop till bcp_sendrow och inget längdprefix eller terminator används, kan du anropa bcp_collen för att återställa längden. Nästa anrop till bcp_sendrow använder längden som sätts av anropet till bcp_collen.

Du måste anropa bcp_collen en gång för varje kolumn i tabellen vars datalängd du vill ändra.