bcp_sendrow

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure 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).

Conteúdo relacionado

  • Última atualização em