Partage via


bcp_columns

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

Définit le nombre total de colonnes trouvées dans le fichier utilisateur à utiliser avec une copie en bloc dans ou hors de SQL Server. bcp_setbulkmode pouvez être utilisé au lieu de bcp_columns et de bcp_colfmt.

Syntaxe

  
RETCODE bcp_columns (  
        HDBC hdbc,  
        INT nColumns);  

Arguments

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

nColumns
Nombre total de colonnes dans le fichier utilisateur. Même si vous préparez à copier en bloc des données du fichier utilisateur vers une table SQL Server et que vous n’avez pas l’intention de copier toutes les colonnes du fichier utilisateur, vous devez toujours définir nColumns sur le nombre total de colonnes de fichier utilisateur.

Retours

SUCCEED ou FAIL.

Notes

Cette fonction ne peut être appelée qu’une fois que bcp_init a été appelée avec un nom de fichier valide.

Vous devez appeler cette fonction uniquement si vous envisagez d'utiliser un format de fichier utilisateur qui diffère du format par défaut. Pour plus d’informations sur une description du format de fichier utilisateur par défaut, consultez bcp_init.

Après avoir appelé bcp_columns, vous devez appeler bcp_colfmt pour chaque colonne du fichier utilisateur pour définir complètement un format de fichier personnalisé.

Voir aussi

Fonctions de copie en bloc