Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Aplica-se a:
SQL ServerBase de Dados SQL do AzureInstância Gerida do Azure SQLAzure Synapse Analytics
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).