bcp_collen

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

Legt die Datenlänge in der Programmvariablen für die aktuelle Massenkopierung in SQL Server fest.

Syntax

  
RETCODE bcp_collen (  
        HDBC hdbc,  
        DBINT cbData,  
        INT idxServerCol);  

Argumente

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

cbData
Die Länge der Daten in der Programmvariable ohne die Länge eines Längenindikators oder Längenabschlusszeichens. Wenn Sie cbData auf SQL_NULL_DATA setzen, wird angegeben, dass alle zum Server kopierten Zeilen einen NULL-Wert für die Spalte enthalten. Wenn Sie es auf SQL_VARLEN_DATA setzen, geben Sie damit an, dass ein Zeichenfolgenabschlusszeichen oder eine andere Methode verwendet wird, um die Länge der kopierten Daten zu bestimmen. Wenn sowohl ein Längenindikator als auch ein Abschlusszeichen vorliegen, bestimmt das System, was verwendet werden soll, daran, bei welchem Vorgang weniger Daten kopiert werden.

idxServerCol
Die Ordnungsposition der Spalte in der Tabelle, in die die Daten kopiert werden. Die erste Spalte ist 1. Die Ordnungsposition einer Spalte wird von SQLColumnsausgegeben.

Gibt zurück

SUCCEED oder FAIL.

Bemerkungen

Mit der bcp_collen-Funktion können Sie die Datenlänge in der Programmvariablen für eine bestimmte Spalte ändern, wenn Sie Daten mit bcp_sendrow in SQL Server kopieren.

Anfänglich wird die Datenlänge beim Aufrufen von bcp_bind bestimmt. Wenn sich die Datenlänge zwischen den Aufrufen von bcp_sendrow ändert und kein Längenpräfix oder -abschlusszeichen verwendet wird, können Sie bcp_collen aufrufen, um die Länge zurückzusetzen. Mit dem nächsten Aufruf von bcp_sendrow wird der Längensatz vom Aufruf von bcp_collenverwendet.

Für jede Spalte in der Tabelle, deren Datenlänge Sie ändern möchten, muss bcp_collen einmal aufgerufen werden.

Weitere Informationen

Bulk Copy Functions