bcp_sendrow

van toepassing op:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Stuurt een rij data van programmavariabelen naar SQL Server.

Syntax

  
RETCODE bcp_sendrow (  
    HDBC hdbc);  

Arguments

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

Returns

SLAGEN OF MISLUKKEN.

Remarks

De bcp_sendrow-functie bouwt een rij op basis van programmavariabelen en stuurt deze naar SQL Server.

Voordat je bcp_sendrow aanroept, moet je aanroepen doen naar bcp_bind om de programmavariabelen met rijgegevens te specificeren.

Als bcp_bind wordt aangeroepen om een lang, variabel lengte datatype te specificeren, bijvoorbeeld een eDataType-parameter van SQLTEXT en een niet-NULL pData-parameter , stuurt bcp_sendrow de volledige datawaarde, net als bij elk ander datatype. Als bcp_bind echter een NULL pData-parameter heeft, geeft bcp_sendrow de controle direct terug aan de applicatie nadat alle kolommen met gespecificeerde gegevens naar SQL Server zijn gestuurd. De applicatie kan vervolgens bcp_moretext herhaaldelijk aanroepen om de lange, variabele data per stuk naar SQL Server te sturen. Voor meer informatie, zie bcp_moretext.

Wanneer bcp_sendrow wordt gebruikt om rijen van programmavariabelen in bulk te kopiëren naar SQL Server tabellen, worden rijen alleen gecommitteerd wanneer de gebruiker bcp_batch of bcp_done aanroept. De gebruiker kan ervoor kiezen om bcp_batch eens per n rijen aan te roepen of wanneer er een pauze is tussen periodes van binnenkomende data. Als bcp_batch nooit wordt aangeroepen, worden de rijen vastgelegd wanneer bcp_done wordt aangeroepen.

Voor informatie over een breaking change in bulk-copying vanaf SQL Server 2005 (9.x), zie Performing Bulk Copy Operations (ODBC).