'bcp_sendrow'

Gilt für:SQL ServerAzure SQL-DatenbankAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Sendet eine Zeile mit Daten aus Programmvariablen an SQL Server.

Syntax

  
RETCODE bcp_sendrow (  
    HDBC hdbc);  

Argumente

hdbc
Das für den Massenkopiervorgang aktivierte ODBC-Verbindungshandle.

Gibt zurück

SUCCEED oder FAIL.

Bemerkungen

Die bcp_sendrow-Funktion erstellt eine Zeile aus Programmvariablen und sendet sie an SQL Server.

Vor dem Aufruf von bcp_sendrowmüssen Sie Aufrufe an bcp_bind vornehmen, um die Programmvariablen mit den Zeilendaten anzugeben.

Wenn bcp_bind aufgerufen wird, der einen langen Datentyp mit variabler Länge angibt, z. B. einen eDataType-Parameter von SQLTEXT und einen pData-Parameter ungleich NULL, sendet bcp_sendrow den gesamten Datenwert, genau wie bei jedem anderen Datentyp. Wenn bcp_bind jedoch über einen pData-Parameter NULL verfügt, gibt bcp_sendrow die Steuerung unmittelbar nach dem Senden aller Spalten mit den angegebenen Daten an SQL Server an die Anwendung zurück. Die Anwendung kann dann bcp_moretext wiederholt aufrufen, um die langen Daten mit variabler Länge an SQL Server zu senden. Weitere Informationen finden Sie unter bcp_moretext.

Wenn bcp_sendrow zum Massenkopieren von Zeilen aus Programmvariablen in SQL Server Tabellen verwendet wird, werden Zeilen nur dann committet, wenn der Benutzer bcp_batch oder bcp_done aufruft. Der Benutzer kann bcp_batch wahlweise einmal für alle n Zeilen aufrufen oder dann, wenn bei den eingehenden Daten eine Pause auftritt. Wird bcp_batch nie aufgerufen, wird ein Commit für die Zeilen ausgeführt, wenn bcp_done aufgerufen wird.

Informationen zu einer Breaking Change beim Massenkopiervorgang ab SQL Server 2005 (9.x) finden Sie unter Ausführen von Massenkopiervorgängen (ODBC).

Weitere Informationen

Bulk Copy Functions