'bcp_sendrow'

Gilt für: SQL Server Azure SQL-Datenbank Azure SQL verwaltete Instanz Azure Synapse Analytics Analytics Platform System (PDW)

Sendet eine Datenzeile 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.

Hinweise

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, um einen Datentyp mit langer Variabler Länge anzugeben, z. B. einen eDataType-Parameter von SQLTEXT und einen Parameter ungleich NULL pData , sendet bcp_sendrow den gesamten Datenwert genauso wie für jeden anderen Datentyp. Wenn bcp_bind jedoch einen NULL-pData-Parameter aufweist, gibt bcp_sendrow die Steuerung unmittelbar nach dem Senden aller Spalten mit angegebenen Daten 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 Massenkopien von Zeilen aus Programmvariablen in SQL Server-Tabellen verwendet wird, werden Zeilen nur übernommen, 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 bedeutenden Änderung des Massenkopiervorgangs ab SQL Server 2005 (9.x) finden Sie unter Ausführen von Massenkopievorgängen (ODBC).

Weitere Informationen

Massenkopierfunktionen