bcp_sendrow

gäller för:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics

Skickar en rad data från programvariabler till SQL Server.

Syntax

  
RETCODE bcp_sendrow (  
    HDBC hdbc);  

Arguments

hdbc
Är den masskopieringsaktiverade ODBC-anslutningshandtaget.

Returns

SUCCEED eller FAIL.

Remarks

Funktionen bcp_sendrow bygger en rad från programvariabler och skickar den till SQL Server.

Innan du anropar bcp_sendrow måste du göra anrop till bcp_bind för att specificera programvariablerna som innehåller raddata.

Om bcp_bind kallas för att specificera en lång, variabel längd datatyp, till exempel en eDataType-parameter i SQLTEXT och en icke-NULL pData-parameter , skickar bcp_sendrow hela datavärdet, precis som för alla andra datatyper. Om bcp_bind däremot har en NULL pData-parameter, återlämnar bcp_sendrow kontrollen till applikationen omedelbart efter att alla kolumner med specificerad data skickats till SQL Server. Applikationen kan sedan anropa bcp_moretext upprepade gånger för att skicka den långa, variabellängds datan till SQL Server, en bit i taget. För mer information, se bcp_moretext.

När bcp_sendrow används för att bulkkopiera rader från programvariabler till SQL Server tabeller, committeras rader endast när användaren anropar bcp_batch eller bcp_done. Användaren kan välja att anropa bcp_batch en gång var n-rad eller när det är en paus mellan inkommande dataperioder. Om bcp_batch aldrig ropas upp, är raderna komponerade när bcp_done anropas.

För information om en brytande förändring i bulkkopiering som började i SQL Server 2005 (9.x), se Performing Bulk Copy Operations (ODBC).