Partilhar via


bcp_collen

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure PDW (Sistema de Plataforma de Análise) do Azure Synapse Analytics

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.

Confira também

Funções de cópia em massa