Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Gilt für: SQL Server
Azure SQL-Datenbank
Azure SQL Managed Instance
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).