bcp_collen

Van toepassing op:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics

Stelt de datalengte in de programmavariabele in voor de huidige bulkkopie in SQL Server.

Syntax

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

Arguments

hdbc-
Is de ODBC-verbindingshandgreep waarvoor bulksgewijs kopiëren is ingeschakeld.

cbData
Is de lengte van de data in de programmavariabele, exclusief de lengte van een lengte-indicator of terminator. Het instellen van cbData op SQL_NULL_DATA geeft aan dat alle rijen die naar de server zijn gekopieerd een NULL-waarde voor de kolom bevatten. Het instellen op SQL_VARLEN_DATA geeft aan dat een stringterminator of andere methode wordt gebruikt om de lengte van de gekopieerde data te bepalen. Als zowel een lengte-indicator als een terminator bestaan, gebruikt het systeem de optie die resulteert in het minder gekopieerde data.

idxServerCol
Is de ordinaalpositie van de kolom in de tabel waarheen de gegevens worden gekopieerd. De eerste kolom is 1. De ordinaalpositie van een kolom wordt gerapporteerd door SQLColumns.

Returns

SLAGEN OF MISLUKKEN.

Remarks

De bcp_collen functie stelt je in staat de gegevenslengte in de programmavariabele voor een bepaalde kolom te wijzigen wanneer je data naar SQL Server met bcp_sendrow kopieert.

Aanvankelijk wordt de gegevenslengte bepaald wanneer bcp_bind wordt aangeroepen. Als de datalengte verandert tussen aanroepen naar bcp_sendrow en er wordt geen lengteprefix of terminator gebruikt, kun je bcp_collen aanroepen om de lengte te resetten. De volgende oproep naar bcp_sendrow gebruikt de lengte die door de oproep naar bcp_collen wordt bepaald.

Je moet bcp_collen één keer aanroepen voor elke kolom in de tabel waarvan je de gegevenslengte wilt wijzigen.