bcp_exec

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.

Retorna

SUCCEED, SUCCEED_ASYNC ou FAIL. A função bcp_exec retornará 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 ocorrer falha total ou se o número de linhas que geram erros atingir 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 de quebra na cópia em massa a partir do SQL Server 2005, 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.

Consulte também

Referência

Funções de cópia em massa