bcp_exec
Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure Azure Synapse Analytics Analytics Platform System (PDW)
Executa uma cópia em massa completa dos dados entre uma tabela de banco de dados e um arquivo de usuário.
Sintaxe
RETCODE bcp_exec (
HDBC hdbc,
LPDBINT pnRowsProcessed);
Argumentos
hdbc
É o identificador de conexão ODBC habilitado para cópia em massa.
pnRowsProcessed
É um ponteiro para um DBINT. A função bcp_exec preenche esse DBINT com o número de linhas copiadas com êxito. Se pnRowsProcessed for NULL, ele será ignorado por bcp_exec.
Devoluções
SUCCEED, SUCCEED_ASYNC ou FAIL. Os lucros de função bcp_exec retornarão SUCCEED se todas as linhas forem copiadas. bcp_exec retornará SUCCEED_ASYNC se uma operação de cópia em massa assíncrona ainda estiver pendente. bcp_exec retornará FAIL se uma falha completa ocorrer, ou se o número de linhas que geram erros alcançar o valor especificado para BCPMAXERRS usando bcp_control. O padrão de BCPMAXERRS é definido como 10. A opção BCPMAXERRS afeta somente os erros de sintaxe detectados pelo provedor ao ler as linhas do arquivo de dados (e não as linhas enviadas para o servidor). O servidor anula o lote ao detectar um erro com uma linha. Verifique o parâmetro pnRowsProcessed para o número de linhas copiadas com êxito.
Comentários
Esta função copia os dados de um arquivo de usuário para uma tabela de banco de dados ou vice-versa, dependendo do valor do parâmetro eDirection em bcp_init.
Antes de chamar bcp_exec, chame bcp_init com um nome de arquivo de usuário válido. Caso isso não seja feito, será gerado um erro.
bcp_exec é a única função de cópia em massa que provavelmente ficará pendente para qualquer duração de tempo. Portanto, é a única função de cópia em massa que suporta o modo assíncrono. Para definir o modo assíncrono, use SQLSetConnectAttr para definir SQL_ATTR_ASYNC_ENABLE como SQL_ASYNC_ENABLE_ON antes de chamar bcp_exec. Para testar se houve a conclusão, chame bcp_exec com os mesmos parâmetros. Se a cópia em massa ainda não tiver sido concluída, bcp_exec retornará SUCCEED_ASYNC. Retornará também em pnRowsProcessed uma contagem de status do número de linhas que foram enviadas para o servidor. As linhas enviadas para o servidor não serão confirmadas até que o fim de um lote seja atingido.
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).
Exemplo
O exemplo a seguir mostra como usar bcp_exec:
// Variables like henv not specified.
HDBC hdbc;
DBINT nRowsProcessed;
// Application initiation, get an ODBC environment handle, allocate the
// hdbc, and so on.
...
// Enable bulk copy prior to connecting on allocated hdbc.
SQLSetConnectAttr(hdbc, SQL_COPT_SS_BCP, (SQLPOINTER) SQL_BCP_ON,
SQL_IS_INTEGER);
// Connect to the data source, return on error.
if (!SQL_SUCCEEDED(SQLConnect(hdbc, _T("myDSN"), SQL_NTS,
_T("myUser"), SQL_NTS, _T("myPwd"), SQL_NTS)))
{
// Raise error and return.
return;
}
// Initialize bulk copy.
if (bcp_init(hdbc, _T("pubs..authors"), _T("authors.sav"), NULL, DB_OUT)
== FAIL)
{
// Raise error and return.
return;
}
// Now, execute the bulk copy.
if (bcp_exec(hdbc, &nRowsProcessed) == FAIL)
{
if (nRowsProcessed == -1)
{
printf_s("No rows processed on bulk copy execution.\n");
}
else
{
printf_s("Incomplete bulk copy. Only %ld row%s copied.\n",
nRowsProcessed, (nRowsProcessed == 1) ? "": "s");
}
return;
}
printf_s("%ld rows processed.\n", nRowsProcessed);
// Carry on.