bcp_collen

Gilt für: SQL Server Azure SQL-Datenbank Azure SQL verwaltete Instanz Azure Synapse Analytics Analytics Platform System (PDW)

Legt die Datenlänge in der Programmvariablen für die aktuelle Massenkopie 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.

Hinweise

Mit der funktion bcp_collen können Sie die Datenlänge in der Programmvariable für eine bestimmte Spalte beim Kopieren von Daten in SQL Server mit bcp_sendrow ändern.

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

Massenkopierfunktionen