bcp_exec

Aplica-se a: SQL Server (todas as versões com suporte) SQL do Azure Banco de Dados Instância Gerenciada de SQL do Azure Azure Synapse PDW (Analytics Analytics Platform System)

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.

Retornos

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 de SQL Server 2005 (9.x), consulte Executar 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.  

Consulte Também

Bulk Copy Functions