bcp_collen

Aplica-se a: SQL ServerBase de Dados SQL do AzureAzure SQL Managed InstanceAzure Synapse AnalyticsSistema de Plataforma de Análise (PDW)

Define o comprimento dos dados na variável do programa para a cópia em massa atual para o SQL Server.

Syntax

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

Arguments

hdbc
É o identificador de conexão ODBC habilitado para cópia em massa.

cbData
É o comprimento dos dados na variável do programa, não incluindo o comprimento de qualquer indicador ou terminador de comprimento. Definir cbData para SQL_NULL_DATA indica que todas as linhas copiadas para o servidor contêm um valor NULL para a coluna. Defini-lo para SQL_VARLEN_DATA indica que um terminador de strings ou outro método é usado para determinar o comprimento dos dados copiados. Se existirem tanto um indicador de comprimento como um terminador, o sistema usa aquele que resulte em menos dados a serem copiados.

idxServerCol
É a posição ordinal da coluna na tabela para onde os dados são copiados. A primeira coluna é 1. A posição ordinal de uma coluna é reportada por SQLColumns.

Devoluções

TER SUCESSO ou FALHAR.

Observações

A função bcp_collen permite alterar o comprimento dos dados na variável do programa para uma coluna específica ao copiar dados para SQL Server com bcp_sendrow.

Inicialmente, o comprimento dos dados é determinado quando bcp_bind é chamado. Se o comprimento dos dados mudar entre chamadas para bcp_sendrow e não estiver a ser usado prefixo de comprimento ou terminador, pode chamar bcp_collen para redefinir o comprimento. A próxima chamada para bcp_sendrow usa o comprimento definido pela chamada para bcp_collen.

Deve chamar bcp_collen uma vez por cada coluna na tabela cujo comprimento de dados pretende modificar.

Conteúdo relacionado

  • Last updated on