Compartilhar via


bcp_sendrow

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

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

Sintaxe

  
RETCODE bcp_sendrow (  
    HDBC hdbc);  

Argumentos

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

Devoluções

SUCCEED ou FAIL.

Comentários

A função bcp_sendrow cria uma linha a partir 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 longo e de comprimento variável, por exemplo, um parâmetro eDataType de SQLTEXT e um parâmetro pData não NULL, bcp_sendrow enviará o valor de dados inteiro, assim como faz para qualquer outro tipo de dados. Se, no entanto, bcp_bind tiver um parâmetro pData NULL, bcp_sendrow retornará o controle para o aplicativo imediatamente após todas as colunas com dados especificados serem enviadas ao SQL Server. Em seguida, o aplicativo pode chamar bcp_moretext repetidamente para enviar os dados longos e de comprimento variável para o SQL Server, uma parte de cada vez. Para obter mais informações, consulte bcp_moretext.

Quando bcp_sendrow é usado para copiar em massa linhas de variáveis de programa para tabelas do 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 do SQL Server 2005 (9.x), consulte Executando operações de cópia em massa (ODBC).

Confira também

Funções de cópia em massa