bcp_sendrow

S’applique à :SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Envoie une ligne de données des variables de programme à SQL Server.

Syntaxe

  
RETCODE bcp_sendrow (  
    HDBC hdbc);  

Arguments

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

Retours

SUCCEED ou FAIL.

Remarques

La fonction bcp_sendrow génère une ligne à partir de variables de programme et l’envoie à SQL Server.

Avant d'appeler bcp_sendrow, vous devez effectuer des appels à bcp_bind pour spécifier les variables de programme qui contiennent des données de ligne.

Si bcp_bind est appelé en spécifiant un type de données long de longueur variable, par exemple, un paramètre eDataType de SQLTEXT et un paramètre pData non NULL, bcp_sendrow envoie la valeur de données entière, comme pour tout autre type de données. Si, toutefois, bcp_bind a un paramètre pData NULL, bcp_sendrow retourne le contrôle à l’application immédiatement après que toutes les colonnes avec des données spécifiées ont été envoyées à SQL Server. L’application peut ensuite appeler bcp_moretext à plusieurs reprises pour envoyer les données de longueur variable à SQL Server, un bloc à la fois. Pour plus d'informations, consultez bcp_moretext.

Lorsque bcp_sendrow est utilisé pour copier en bloc des lignes à partir de variables de programme dans SQL Server tables, les lignes sont validées uniquement lorsque l’utilisateur appelle bcp_batch ou bcp_done. L'utilisateur peut choisir d'appeler bcp_batch une fois chaque n lignes ou lors de creux entre deux périodes de données entrantes. Si bcp_batch n'est jamais appelé, les lignes sont validées lorsque bcp_done est appelé.

Pour plus d’informations sur une modification cassante de la copie en bloc à partir de SQL Server 2005 (9.x), consultez Exécution d’opérations de copie en bloc (ODBC).

Voir aussi

Bulk Copy Functions