bcp_collen
Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure Azure Synapse Analytics Analytics Platform System (PDW)
Define o comprimento dos dados na variável de programa para a cópia em massa atual no SQL Server.
Sintaxe
RETCODE bcp_collen (
HDBC hdbc,
DBINT cbData,
INT idxServerCol);
Argumentos
hdbc
É o identificador de conexão ODBC habilitado para cópia em massa.
cbData
É o comprimento dos dados na variável de programa, não incluindo o comprimento dos indicadores ou terminadores de comprimento. A definição de cbData como SQL_NULL_DATA indica que todas as linhas copiadas no servidor contêm um valor NULL na coluna. Defini-lo como SQL_VARLEN_DATA indica que um terminador da cadeia de caracteres ou outro método é usado para determinar o comprimento dos dados copiados. Se um indicador de comprimento e um terminador existirem, o sistema usará o que resultar em menos cópia de dados.
idxServerCol
É a posição ordinal da coluna na tabela na qual os dados são copiados. A primeira coluna é 1. A posição ordinal de uma coluna é relatada por SQLColumns.
Devoluções
SUCCEED ou FAIL.
Comentários
A função bcp_collen permite alterar o comprimento dos dados na variável de programa de uma coluna específica ao copiar dados para o SQL Server com bcp_sendrow.
Inicialmente, o comprimento de dados é determinado quando bcp_bind é chamado. Se o comprimento de dados for alterado entre as chamadas para bcp_sendrow e nenhum prefixo de comprimento ou terminador for usado, você poderá chamar bcp_collen para redefinir o comprimento. A próxima chamada para bcp_sendrow usará o comprimento definido pela chamada para bcp_collen.
Você deve chamar bcp_collen uma vez para cada coluna na tabela cujo comprimento de dados deseje modificar.