bcp_sendrow

Dotyczy:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Wysyła wiersz danych ze zmiennych programowych do SQL Server.

Syntax

  
RETCODE bcp_sendrow (  
    HDBC hdbc);  

Arguments

hdbc
Czy obsługa połączenia ODBC z obsługą kopiowania zbiorczego.

Zwroty

POWODZENIE lub NIEPOWODZENIE.

Remarks

Funkcja bcp_sendrow tworzy wiersz ze zmiennych programu i wysyła go do SQL Server.

Przed wywołaniem bcp_sendrow musisz wykonać wywołania bcp_bind , aby określić zmienne programowe zawierające dane wierszowe.

Jeśli bcp_bind nazywa się określeniem długiego, zmiennie długiego typu danych, na przykład parametru eDataType w SQLTEXT oraz parametru pData nie-NULL, bcp_sendrow wysyła całą wartość danych, tak jak dla każdego innego typu danych. Jeśli jednak bcp_bind ma parametr NULL pData, bcp_sendrow zwraca kontrolę aplikacji natychmiast po wysłaniu wszystkich kolumn z podanymi danymi do SQL Server. Aplikacja może następnie wywoływać bcp_moretext wielokrotnie, aby przesyłać długie, zmiennie długie dane do SQL Server, kawałek po kawałku. Więcej informacji można znaleźć w bcp_moretext.

Gdy bcp_sendrow jest używany do masowego kopiowania wierszy ze zmiennych programu do SQL Server tabel, wiersze są zatwierdzane tylko wtedy, gdy użytkownik wywołuje bcp_batch lub bcp_done. Użytkownik może wybrać, czy wywołać bcp_batch raz na n wierszy lub gdy występuje przerwa między okresami napływających danych. Jeśli bcp_batch nigdy nie zostanie wywołane, wiersze są zatwierdzane w momencie bcp_done .

Informacje o przełomowej zmianie w kopiowaniu masowym rozpoczynającej się w SQL Server 2005 (9.x) można znaleźć w artykule Wykonywanie operacji kopiowania masowego (ODBC).