bcp_columns

  • Artikel

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

Legt die Gesamtanzahl der Spalten fest, die in der Benutzerdatei für die Verwendung mit einem Massenkopiervorgang in oder aus SQL Server gefunden werden. bcp_setbulkmode können anstelle von bcp_columns und bcp_colfmt verwendet werden.

Syntax

  
RETCODE bcp_columns (  
        HDBC hdbc,  
        INT nColumns);

Argumente

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

nColumns
Die Gesamtzahl der Spalten in der Benutzerdatei. Auch wenn Sie das Massenkopieren von Daten aus der Benutzerdatei in eine SQL Server Tabelle vorbereiten und nicht beabsichtigen, alle Spalten in der Benutzerdatei zu kopieren, müssen Sie nColumns dennoch auf die Gesamtanzahl der Benutzerdateispalten festlegen.

Gibt zurück

SUCCEED oder FAIL.

Bemerkungen

Diese Funktion kann nur aufgerufen werden , nachdem bcp_init mit einem gültigen Dateinamen aufgerufen wurde.

Sie sollten diese Funktion nur aufrufen, wenn Sie ein Benutzerdateiformat verwenden möchten, das sich vom Standardformat unterscheidet. Weitere Informationen zu einer Beschreibung des Standardmäßigen Benutzerdateiformats finden Sie unter bcp_init.

Nachdem Sie bcp_columns aufgerufen haben, müssen Sie bcp_colfmt für jede Spalte in der Benutzerdatei aufrufen, um ein benutzerdefiniertes Dateiformat vollständig zu definieren.

Weitere Informationen

Bulk Copy Functions