bcp_control

Altera as configurações padrão para vários parâmetros de controle para uma cópia em massa entre um arquivo e o SQL Server.

Sintaxe

  
RETCODE bcp_control (  
HDBC   
hdbc  
,  
INT   
eOption  
,  
void*   
iValue  
);  
  

Argumentos

hdbc
É o identificador de conexão ODBC habilitado para cópia em massa.

eOption
É um dos seguintes:

BCPABORT
Interrompe uma operação de cópia em massa que já está em andamento. Chame bcp_control com uma eOption de BCPABORT de outro thread para interromper uma operação de cópia em massa em execução. O parâmetro iValue é ignorado.

BCPBATCH
É o número de linhas por lote. O padrão é 0, que indica todas as linhas em uma tabela, quando os dados estão sendo extraídos ou todas as linhas no arquivo de dados do usuário, quando os dados estão sendo copiados para um SQL Server. Um valor menor que 1 redefine BCPBATCH para o padrão.

BCPDELAYREADFMT
Um booliano, se definido como true, fará com que bcp_readfmt leia na execução. Se for false (o padrão), bcp_readfmt lerá imediatamente o arquivo de formato. Ocorrerá um erro de sequência se BCPDELAYREADFMT for true e você chamar bcp_columns ou bcp_setcolfmt.

Um erro de sequência também ocorrerá se você chamar bcp_control(hdbc, BCPDELAYREADFMT, (void *)FALSE) depois de chamar bcp_control(hdbc, BCPDELAYREADFMT, (void *)TRUE) e bcp_writefmt.

Para obter mais informações, consulte a Descoberta de Metadados.

BCPFILECP
IValue contém o número da página de código do arquivo de dados. Você pode especificar o número da página de código, como 1252 ou 850, ou um destes valores:

BCPFILE_ACP: os dados no arquivo estão no Microsoft Windows?? página de código do cliente.

BCPFILE_OEMCP: os dados no arquivo estão na página de código OEM do cliente (padrão).

BCPFILE_RAW: os dados no arquivo estão na página de código do SQL Server.

BCPFILEFMT
O número de versão do formato do arquivo de dados. Isso pode ser 80 (SQL Server 2000), 90 (SQL Server 2005), 100 (SQL Server 2008 ou SQL Server 2008 R2), 110 (SQL Server 2012) ou 120 (SQL Server 2014). 120 é o padrão. Isso é útil para exportar e importar dados em formatos compatíveis com a versão anterior do servidor. Por exemplo, para importar dados obtidos de uma coluna de texto em um servidor SQL Server 2000 para uma coluna varchar(max) em um SQL Server 2005 ou posterior, especifique 80. Da mesma forma, se você especificar 80 ao exportar dados de uma coluna varchar(max ), ela será salva assim como as colunas de texto são salvas no formato SQL Server 2000 e podem ser importadas para uma coluna de texto de um servidor SQL Server 2000.

BCPFIRST
É a primeira linha de dados para arquivo ou tabela a ser copiada. O padrão é 1; um valor menor que 1 redefine essa opção para seu padrão.

BCPFIRSTEX
Para operações de saída bcp, especifica a primeira linha da tabela de banco de dados a ser copiada para o arquivo de dados.

Para BCP em operações, especifica a primeira linha do arquivo de dados a ser copiada para a tabela de banco de dados.

Espera-se que o parâmetro iValue seja o endereço de um inteiro de 64 bits assinado que contém o valor. O valor máximo que pode ser passado para BCPFIRSTEX é 2^63-1.

BCPFMTXML
Especifica que o arquivo de formato gerado deve estar no formato XML. Ele está desativado por padrão.

Os arquivos de formato XML fornecem maior flexibilidade, mas com algumas restrições adicionais. Por exemplo, você não pode especificar o prefixo e o terminador para um campo simultaneamente, o que era possível em arquivos de formato mais antigos.

BCPHINTS
IValue contém um ponteiro de cadeia de caracteres SQLTCHAR. A cadeia de caracteres endereçada especifica dicas de processamento de cópia em massa do SQL Server ou uma instrução Transact-SQL que retorna um conjunto de resultados. Se uma instrução Transact-SQL for especificada que retorna mais de um conjunto de resultados, todos os conjuntos de resultados após o primeiro serão ignorados. Para obter mais informações sobre dicas de processamento de cópia em massa, consulte bcp Utility.

BCPKEEPIDENTITY
Quando iValue é TRUE, especifica que as funções de cópia em massa inserem valores de dados fornecidos para colunas do SQL Server definidas com uma restrição de identidade. O arquivo de entrada deve fornecer valores para as colunas de identidade. Se isso não estiver definido, novos valores de identidade serão gerados para as linhas inseridas. Todos os dados presentes no arquivo para as colunas de identidade são ignorados.

BCPKEEPNULLS
Especifica se os valores de dados vazios no arquivo serão convertidos em valores NULL na tabela do SQL Server. Quando iValue for TRUE, valores vazios serão convertidos em NULL na tabela do SQL Server. O padrão é que valores vazios sejam convertidos em um valor padrão para a coluna na tabela do SQL Server se houver um padrão.

BCPLAST
É a última linha a ser copiada. O padrão é copiar todas as linhas; um valor menor que 1 redefine essa opção para seu padrão.

BCPLASTEX
Para operações de saída bcp, especifica a última linha da tabela de banco de dados a ser copiada para o arquivo de dados.

Para BCP em operações, especifica a última linha do arquivo de dados a ser copiada para a tabela de banco de dados.

Espera-se que o parâmetro iValue seja o endereço de um inteiro de 64 bits assinado que contém o valor. O valor máximo que pode ser passado para BCPLASTEX é 2^63-1.

BCPMAXERRS
É o número de erros permitidos antes que a operação de cópia em massa falhe. O padrão é 10; um valor menor que 1 redefine essa opção para seu padrão. A cópia em massa impõe um máximo de 65.535 erros. Uma tentativa de definir essa opção para um valor maior que 65.535 resulta na opção sendo definida como 65.535.

BCPODBC
Quando TRUE, especifica que os valores datetime e smalldatetime salvos no formato de caractere usarão o prefixo e o sufixo da sequência de escape do carimbo de data/hora ODBC. A opção BCPODBC só se aplica a BCP_OUT.

Quando FALSE, um valor de datetime que representa 1º de janeiro de 1997 é convertido na cadeia de caracteres: 1997-01-01 00:00:00.000. Quando TRUE, o mesmo valor de datetime é representado como: {ts '1997-01-01 00:00:00.000'}.

BCPROWCOUNT
Retorna o número de linhas afetadas pela operação BCP atual (ou última).

BCPTEXTFILE
Quando TRUE, especifica que o arquivo de dados é um arquivo de texto, em vez de um arquivo binário. Se o arquivo for um arquivo de texto, BCP determinará se ele é Ou não Unicode verificando o marcador de bytes Unicode nos dois primeiros bytes do arquivo de dados.

BCPUNICODEFILE
Quando TRUE, especifica que o arquivo de entrada é um arquivo Unicode.

iValue
É o valor do eOption especificado. iValue é um valor inteiro (LONGLONG) convertido em um ponteiro nulo para permitir a expansão futura para valores de 64 bits.

Devoluções

SUCCEED ou FAIL.

Observações

Essa função define vários parâmetros de controle para operações de cópia em massa, incluindo o número de erros permitidos antes de cancelar uma cópia em massa, os números da primeira e última linhas a serem copiadas de um arquivo de dados e o tamanho do lote.

Essa função também é usada para especificar a instrução SELECT ao copiar em massa do SQL Server o conjunto de resultados de um SELECT. Defina eOption como BCPHINTS e defina iValue para ter um ponteiro para uma cadeia de caracteres SQLTCHAR que contém a instrução SELECT.

Esses parâmetros de controle só são significativos ao copiar entre um arquivo de usuário e uma tabela do SQL Server. As configurações de parâmetro de controle não têm efeito sobre as linhas copiadas para o SQL Server com bcp_sendrow.

Exemplo

// Variables like henv not specified.  
SQLHDBC      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("address"), _T("address.add"), _T("addr.err"),  
   DB_IN) == FAIL)  
   {  
   // Raise error and return.  
   return;  
   }  
  
// Set the number of rows per batch.   
if (bcp_control(hdbc, BCPBATCH, (void*) 1000) == FAIL)  
   {  
   // Raise error and return.  
   return;  
   }  
  
// Set file column count.   
if (bcp_columns(hdbc, 1) == FAIL)  
   {  
   // Raise error and return.  
   return;  
   }  
  
// Set the file format.   
if (bcp_colfmt(hdbc, 1, 0, 0, SQL_VARLEN_DATA, '\n', 1, 1)  
   == FAIL)  
   {  
   // Raise error and return.  
   return;  
   }  
  
// Execute the bulk copy.   
if (bcp_exec(hdbc, &nRowsProcessed) == FAIL)  
   {  
   // Raise error and return.  
   return;  
   }  
  
printf_s("%ld rows processed by bulk copy.", nRowsProcessed);  
  

Consulte Também

Funções de cópia em massa