'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).