bcp_collen

S’applique à : SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

Définit la longueur des données dans la variable de programme pour la copie en bloc actuelle dans SQL Server.

Syntaxe

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

Arguments

hdbc
Handle de connexion ODBC compatible avec la copie en bloc.

cbData
Longueur des données dans la variable de programme, à l'exclusion de la longueur de tout indicateur de longueur ou terminateur. La définition de cbData avec la valeur SQL_NULL_DATA indique que toutes les lignes copiées sur le serveur contiennent une valeur NULL pour la colonne. La définition de cbData avec la valeur SQL_VARLEN_DATA indique qu'un terminateur de chaîne ou une autre méthode est utilisé pour déterminer la longueur des données copiées. S'il existe à la fois un indicateur de longueur et un terminateur, le système utilise celui qui entraîne la copie du moins grand nombre de données.

idxServerCol
Position ordinale de la colonne dans la table vers laquelle les données sont copiées. La première colonne est 1. La position ordinale d'une colonne est indiquée par SQLColumns.

Retours

SUCCEED ou FAIL.

Notes

La fonction bcp_collen vous permet de modifier la longueur des données dans la variable de programme pour une colonne particulière lors de la copie de données vers SQL Server avec bcp_sendrow.

Initialement, la longueur de données est déterminée quand bcp_bind est appelé. Si la longueur de données change entre des appels à bcp_sendrow et qu'aucun préfixe de longueur ou terminateur n'est en cours d'utilisation, vous pouvez appeler bcp_collen pour réinitialiser la longueur. L'appel suivant à bcp_sendrow utilise la longueur définie par l'appel à bcp_collen.

Vous devez appeler bcp_collen une fois pour chaque colonne de la table dont vous voulez modifier la longueur de données.

Voir aussi

Fonctions de copie en bloc