bcp_sendrow

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

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

Syntax

  
RETCODE bcp_sendrow (  
    HDBC hdbc);  

Arguments

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

Devoluções

TER SUCESSO ou FALHAR.

Observações

A função bcp_sendrow constrói uma linha a partir de variáveis de programa e envia-a para SQL Server.

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

Se bcp_bind for chamado especificar um tipo de dado longo e de comprimento variável, por exemplo, um parâmetro eDataType de SQLTEXT e um parâmetro pData não NULL, bcp_sendrow envia o valor total dos dados, tal como acontece com qualquer outro tipo de dado. Se, no entanto, bcp_bind tiver um parâmetro NULL pData, bcp_sendrow devolve o controlo à aplicação imediatamente após todas as colunas com dados especificados serem enviadas para SQL Server. A aplicação pode então chamar bcp_moretext repetidamente para enviar os dados longos e de comprimento variável para SQL Server, um bloco de cada vez. Para mais informações, consulte bcp_moretext.

Quando bcp_sendrow é usado para copiar em massa linhas de variáveis de programa para SQL Server tabelas, as linhas só são comprometidas quando o utilizador chama bcp_batch ou bcp_done. O utilizador pode escolher chamar bcp_batch uma vez a cada n linhas ou quando houver uma pausa entre períodos de dados recebidos. Se bcp_batch nunca for chamada, as linhas são comprometidas quando bcp_done é chamada.

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

Conteúdo relacionado

• Extensões de Drivers SQL Server - Funções de Cópia em Massa