Compartir a través de


bcp_collen

Se aplica a: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

Establece la longitud de los datos en la variable de programa para la copia masiva actual en SQL Server.

Sintaxis

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

Argumentos

hdbc
Es el identificador de la conexión ODBC habilitada para la copia masiva.

cbData
Es la longitud de los datos de la variable del programa; no incluye la longitud del indicador ni del terminador de longitud. Si se establece cbData en SQL_NULL_DATA, se indica que todas las filas copiadas en el servidor contienen un valor NULL para la columna. Si se establece en SQL_VARLEN_DATA, se indica que se utiliza un terminador de cadena u otro método para determinar la longitud de los datos copiados. Si hay un indicador y un terminador de longitud, el sistema utiliza el que permita que se copien menos datos.

idxServerCol
Es la posición ordinal de la columna en la tabla en la que se copian los datos. La primera columna es 1. La posición ordinal de una columna se notifica mediante SQLColumns.

Devoluciones

SUCCEED o FAIL.

Comentarios

La función bcp_collen permite cambiar la longitud de los datos de la variable de programa de una columna determinada al copiar datos en SQL Server con bcp_sendrow.

La longitud de los datos se determina inicialmente cuando se llama a bcp_bind . Si la longitud de los datos cambia entre las llamadas a bcp_sendrow y no se utiliza ningún prefijo o terminador de longitud, puede llamar a bcp_collen para restablecer la longitud. La llamada siguiente a bcp_sendrow utiliza la longitud establecida por la llamada a bcp_collen.

Debe llamar una vez a bcp_collen para cada columna de la tabla cuya longitud de los datos desee modificar.

Consulte también

Funciones de copia masiva