bcp_sendrow

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure Synapse AnalyticsPDW (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 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 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 com qualquer outro tipo de dados. No entanto, se 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 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 para 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 interruptiva na cópia em massa a partir do SQL Server 2005 (9.x), consulte Executando operações de cópia em massa (ODBC).

Consulte Também

Bulk Copy Functions