bcp_sendrow

Aplica-se a: SQL Server (todas as versões com suporte) SQL do Azure Banco de Dados Instância Gerenciada de SQL do Azure Azure Synapse PDW (Analytics Analytics Platform System)

Envia uma linha de dados de variáveis de programa para SQL Server.

Sintaxe

  
RETCODE bcp_sendrow (  
    HDBC hdbc);  

Argumentos

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

Retornos

SUCCEED ou FAIL.

Comentários

A função bcp_sendrow cria uma linha de variáveis de programa e a envia para SQL Server.

Antes de chamar bcp_sendrow, você deve fazer chamadas para bcp_bind para especificar as variáveis de programa que contêm os dados da linha.

Se bcp_bind for chamado especificando um tipo de dados de comprimento variável longo, por exemplo, um parâmetro eDataType de SQLTEXT e um parâmetro pData não NULL, bcp_sendrow enviará todo o valor de dados, assim como faz para qualquer outro tipo de dados. Se, no entanto, bcp_bind tiver um parâmetro nulo pData, bcp_sendrow retornará o controle para o aplicativo imediatamente depois que todas as colunas com dados especificados forem enviadas para SQL Server. Em seguida, o aplicativo pode chamar bcp_moretext repetidamente para enviar os dados longos de comprimento variável para SQL Server, uma parte de cada vez. Para obter mais informações, consulte bcp_moretext.

Quando bcp_sendrow é usado para copiar linhas em massa de variáveis de programa em tabelas SQL Server, as linhas são confirmadas somente quando o usuário chama bcp_batch ou bcp_done. O usuário pode escolher chamar bcp_batch uma vez a cada n linhas ou quando houver uma pausa entre períodos de dados de entrada. Se bcp_batch nunca for chamado, as linhas serão confirmadas quando bcp_done for chamado.

Para obter informações sobre uma alteração significativa na cópia em massa a partir de SQL Server 2005 (9.x), consulte Executar Operações de Cópia em Massa (ODBC).

Consulte Também

Bulk Copy Functions