Artigo
09/28/2010

Utilitário bcp

O utilitário bcp copia dados em massa entre uma instância do MicrosoftSQL Server e um arquivo de dados em um formato especificado pelo usuário. O utilitário bcp pode ser usado para importar grande número de novas linhas em tabelas do SQL Server ou para exportar dados de tabelas para arquivos de dados. Exceto quando usado com a opção queryout, o utilitário não requer nenhum conhecimento de Transact-SQL. Para importar dados para uma tabela, você deve usar um arquivo de formato criado para aquela tabela ou entender a estrutura da tabela e os tipos de dados válidos para suas colunas.

Ícone de vínculo de tópico Para obter as convenções de sintaxe usadas para a sintaxe bcp, consulte convenções de sintaxe Transact-SQL (Transact-SQL).

Observação
Se você usar bcp para fazer backup dos dados, crie um arquivo de formato para registrar o formato dos dados. Os arquivos de dados bcp não incluem nenhum esquema ou informações de formato, portanto, se uma tabela ou exibição for descartada e não tiver um arquivo de formato, não será possível importar os dados.

Sintaxe

bcp {[[database_name.][schema].]{table_name | view_name} | "query"}
    {in | out | queryout | format} data_file
    [-m max_errors] [-f format_file] [-x] [-e err_file]
    [-F first_row] [-L last_row] [-b batch_size]
    [-n] [-c] [-N] [-w] [-V (70 | 80 | 90 )] 
    [-q] [-C { ACP | OEM | RAW | code_page } ] [-t field_term] 
    [-r row_term] [-i input_file] [-o output_file] [-a packet_size]
    [-S server_name[\instance_name]] [-U login_id] [-P password]
    [-T] [-v] [-R] [-k] [-E] [-h"hint [,...n]"]

Argumentos

database_name
É o nome do banco de dados no qual a tabela ou exibição especificada reside. Se não estiver especificado, esse será o banco de dados padrão do usuário.
owner
É o nome do proprietário da tabela ou exibição. O owner será opcional se o usuário que executar a operação for o proprietário da tabela ou exibição especificada. Se o ownernão estiver especificado e o usuário que executa a operação não possuir a tabela ou exibição especificada, o SQL Server retornará uma mensagem de erro e a operação será cancelada.
table_name
É o nome da tabela de destino ao importar dados no SQL Server (in) e da tabela de origem ao exportar dados do SQL Server (out).
view_name
É o nome da exibição de destino ao copiar dados no SQL Server (in) e da exibição de origem ao copiar dados do SQL Server (out). Somente as exibições nas quais todas as colunas fazem referência à mesma tabela podem ser usadas como exibições de destino. Para obter mais informações sobre as restrições para copiar dados em exibições, consulte INSERT (Transact-SQL).
"query"
É uma consulta Transact-SQL que retorna um conjunto de resultados. Se a consulta retornar vários conjuntos de resultados, como uma instrução SELECT que especifica uma cláusula COMPUTE, somente o primeiro conjunto de resultados será copiado no arquivo de dados e os conjuntos de resultados subseqüentes serão ignorados. Coloque a consulta entre aspas duplas e qualquer coisa incorporada na consulta entre aspas simples. queryout também deverá ser especificado quando você copiar dados em massa de uma consulta.

A consulta pode fazer referência a um procedimento armazenado desde que todas as tabelas referenciadas no procedimento armazenado existam antes da execução da instrução bcp. Por exemplo, se o procedimento armazenado gerar uma tabela temporária, ocorrerá uma falha com a instrução bcp, pois a tabela temporária ficará disponível somente em tempo de execução e não durante o tempo de execução da instrução. Nesse caso, considere a inserção do resultado do procedimento armazenado em uma tabela e, em seguida, usar bcp para copiar os dados da tabela para um arquivo de dados.
in | out| queryout | format
Especifica a direção da cópia em massa, do seguinte modo:
- in copia de um arquivo em uma tabela ou exibição de banco de dados.
- out copia da tabela ou exibição de banco de dados para um arquivo. Se você especificar um arquivo existente, o arquivo será substituído. Ao extrair dados, observe que o utilitário bcp representa uma cadeia de caracteres vazia como nula e uma cadeia de caracteres nula como uma cadeia de caracteres vazia.
- queryout copia de uma consulta e só deve ser especificado quando você copiar dados em massa de uma consulta.
- format cria um arquivo de formato com base na opção especificada (-n, -c, -w ou -N) e nos delimitadores da tabela ou exibição. Quando você copia dados em massa, o comando bcp pode fazer referência a um arquivo de formato, o que evita a redigitação das informações de formato interativamente. A opção format requer a opção -f; a criação de um arquivo de formato XML também requer a opção -x. Para obter mais informações, consulte Criando um arquivo de formato.
data_file
É o caminho completo do arquivo de dados. Quando dados são importados em massa para o SQL Server, o arquivo de dados contém os dados a serem copiados na tabela ou exibição especificada. Quando dados são exportados em massa do SQL Server, o arquivo de dados contém os dados copiados da tabela ou exibição. O caminho pode ter de 1 a 255 caracteres. O arquivo de dados pode conter no máximo 263 - 1 linhas.

Importante

Para a opção format, você deve especificar nul como o valor de data_file (formatnul).
-mmax_errors
Especifica o número máximo de erros de sintaxe que podem ocorrer antes de a operação bcp ser cancelada. Um erro de sintaxe indica um erro de conversão de dados no tipo de dados de destino. O total max_errors exclui todos os erros que só podem ser detectados no servidor, como violações de restrição.

Uma linha que não possa ser copiada pelo utilitário bcp é ignorada e é contada como um erro. Se essa opção não estiver incluída, o padrão será 10.

Observação

A opção -m também não se aplica à conversão de money nem tipos de dados bigint.

Importante
Para a opção format, você deve especificar nul como o valor de data_file (formatnul).

Observação
A opção -m também não se aplica à conversão de money nem tipos de dados bigint.

-fformat_file
Especifica o caminho completo de um arquivo de formato. O significado dessa opção depende do ambiente no qual é usada, do seguinte modo:

Se -f for usado com a opção format, o format_file especificado será criado para a tabela ou exibição especificada. Para criar um arquivo de formato XML, especifique também a opção -x. Para obter mais informações, consulte Criando um arquivo de formato.

Se usado com a opção in ou out, -f requer um arquivo de formato existente.

Observação
É opcional usar um arquivo de formato in com a opçãoin ou out. Na ausência da opção -f, se -n, -c, -w ou -N não forem especificados, o comando solicitará informações de formato e permitirá que você salve suas respostas em um arquivo de formato (cujo nome de arquivo padrão é Bcp.fmt).

-x
Usado com as opções format e -fformat_file, gera um arquivo de formato baseado em XML em vez do arquivo de formato padrão não XML. O -x não funciona ao importar ou exportar dados. Ele gera um erro se usado sem format e sem -fformat_file.

Observação
Para usar a opção -x, você deve estar usando um cliente bcp 10.0. Para obter mais informações sobre como usar o cliente bcp 10.0, consulte "Comentários", mais adiante neste tópico.

-eerr_file
Especifica o caminho completo de um arquivo de erro usado para armazenar todas as linhas que o utilitário bcp não puder transferir do arquivo para o banco de dados. As mensagens de erro do comando bcp vão para a estação de trabalho do usuário. Se essa opção não for usada, o arquivo de erros não será criado.
-Ffirst_row
Especifica o número da primeira linha a exportar de uma tabela ou a importar de um arquivo de dados. Esse parâmetro requer um valor maior que (>) 0, mas menor que (<) ou igual ao (=) número total de linhas. Na ausência desse parâmetro, o padrão é a primeira linha do arquivo.

first_row pode ser um inteiro positivo com um valor de até 2^63-1. -Ffirst_row é baseado em 1.
-Llast_row
Especifica o número da última linha a ser exportada de uma tabela ou importada de um arquivo de dados. Esse parâmetro exige um valor maior que (>) 0, mas menor que (<) ou igual ao (=) número da última linha. Na ausência desse parâmetro, o padrão é a última linha do arquivo.

last_row pode ser um inteiro positivo com um valor de até 2^63-1.
-bbatch_size
Especifica o número de linhas por lote de dados importados. Cada lote é importado e registrado como uma transação separada que importa o lote inteiro antes de ser confirmado. Por padrão, todas as linhas no arquivo de dados são importadas como um lote. Para distribuir as linhas entre vários lotes, especifique um batch_size que seja menor que o número de linhas no arquivo de dados. Se a transação apresentar falha para qualquer lote, somente as inserções do lote atual serão revertidas. Os lotes já importados por transações confirmadas não serão afetados por uma falha posterior.

Não use essa opção junto com a opção **h"**ROWS_PER_BATCH =bb".

Para obter mais informações, consulte Gerenciando lotes para importar em massa.
-n
Executa a operação de cópia em massa usando os tipos de dados nativos (banco de dados) dos dados. Essa opção não solicita informações para cada campo; ela usa os valores nativos.

Para obter mais informações, consulte Usando formato nativo para importar ou exportar dados.
-c
Executa a operação usando um tipo de dados de caractere. Essa opção não solicita informações para cada campo; ela usa char como o tipo de armazenamento, sem prefixos e com \t (caractere de tabulação) como separador de campos e \r\n (caractere de nova linha) como terminador de linha.

Para obter mais informações, consulte Usando formato de caractere para importar ou exportar dados.
-N
Executa a operação de cópia em massa usando os tipos de dados nativos (banco de dados) para dados que não sejam de caracteres, e caracteres Unicode para dados de caracteres. Essa opção oferece um desempenho mais elevado alternativo à opção -w e deve ser usada para transferir dados de uma instância do SQL Server para outra usando um arquivo de dados. Ela não solicita informações para cada campo. Use essa opção quando estiver transferindo dados que contenham caracteres estendidos ANSI e quiser aproveitar o desempenho do modo nativo.

Para obter mais informações, consulte Usando o formato nativo Unicode para importar ou exportar dados.

A partir do SQL Server 2005 SP1, se você exportar e importar dados para o mesmo esquema de tabela usando o bcp.exe com - N, poderá ver um aviso de truncamento se houver uma coluna de caracteres não Unicode de comprimento fixo (por exemplo, char(10)).

O aviso poderá ser ignorado. Um modo de resolver esse aviso é usar -n em vez de -N.
-w
Executa a operação de cópia em massa usando caracteres Unicode. Essa opção não solicita informações para cada campo; ela usa nchar como o tipo de armazenamento, sem prefixos, \t (caractere de tabulação) como separador de campos e \n (caractere de nova linha) como terminador de linha.

Para obter mais informações, consulte Uso do formato de caractere Unicode para importar ou exportar dados.
-V (70 | 80 | 90 )
Executa a operação de cópia em massa usando os tipos de dados de uma versão anterior do SQL Server. Essa opção não solicita informações para cada campo; ela usa os valores padrão.

70 = SQL Server 7.0

80 = SQL Server 2000

90 = SQL Server 2005

Por exemplo, para gerar dados para tipos que não tenham suporte no SQL Server 7.0, mas que foram introduzidos em versões posteriores do SQL Server (por exemplo, bigint, sql_variant e xml), use a opção -V70.

Para obter mais informações, consulte Importando dados de formato de caractere e nativo de versões anteriores do SQL Server.
-q
Executa a instrução SET QUOTED_IDENTIFIERS ON na conexão entre o utilitário bcp e uma instância do SQL Server. Use essa opção para especificar um nome de banco de dados, proprietário, tabela ou exibição que contenha um espaço ou aspas simples. Inclua todo o nome da tabela de três partes ou da exibição entre aspas duplas ("").

Para especificar um nome de banco de dados que contenha um espaço ou aspas simples, você deve usar a opção –q.

Para obter mais informações, consulte Comentários mais adiante neste tópico.

-C { ACP | OEM | RAW | code_page }
Especifica a página de código dos dados no arquivo de dados. code_page será relevante apenas se os dados contiverem colunas char, varchar ou text com valores de caracteres maiores do que 127 ou menores do que 32.

Observação
Recomendamos que você especifique um nome de agrupamento para cada coluna em um arquivo de formato.

Valor da página de código	Descrição
ACP	ANSI/Microsoft Windows (ISO 1252).
OEM	Página de código padrão usada pelo cliente. Essa é a página de código padrão usada se -C não for especificado.
RAW	Não ocorre nenhuma conversão de uma página de código para outra. Essa é a opção mais rápida porque não ocorre nenhuma conversão.
code_page	Um número de página de código específico, por exemplo, 850. Importante O SQL Server não suporta a página de código 65001 (codificação UTF-8).

Para obter mais informações, consulte Copiando dados entre agrupamentos diferentes.

-tfield_term
Especifica o terminador de campo. O padrão é \t (caractere de tabulação). Use esse parâmetro para substituir o terminador de campo padrão. Para obter mais informações, consulte Especificando terminadores de campo e linha.
-rrow_term
Especifica o terminador de linha. O padrão é \n (caractere de nova linha). Use esse parâmetro para substituir o terminador de linha padrão. Para obter mais informações, consulte Especificando terminadores de campo e linha.
-iinput_file
Especifica o nome de um arquivo de resposta que contém as respostas às perguntas do prompt de comando para cada campo de dados quando uma cópia em massa é feita usando-se o modo interativo (-n, -c, -w ou -N não especificados).
-ooutput_file
Especifica o nome de um arquivo que recebe a saída redirecionada do prompt de comando.
-apacket_size
Especifica o número de bytes, por pacote de rede, enviados do servidor e para ele. A opção de configuração do servidor pode ser definida usando-se o SQL Server Management Studio (ou o procedimento armazenado do sistema sp_configure). Contudo, a opção de configuração do servidor pode ser substituída individualmente usando-se esta opção. packet_size pode ser de 4096 a 65535 bytes, e o padrão é 4096.

Um tamanho de pacote maior pode aumentar o desempenho de operações de cópia em massa. Se um pacote maior for solicitado mas não puder ser concedido, o padrão será usado. As estatísticas de desempenho geradas pelo utilitário bcp mostram o tamanho de pacote usado.
-Sserver_name[ **\instance_name]
Especifica uma instância do SQL Server à qual se conectar. Se nenhum servidor for especificado, o utilitário bcp se conectará à instância padrão do SQL Server no computador local. Essa opção é necessária quando um comando bcp é executado de um computador remoto na rede ou de uma instância local nomeada. Para se conectar à instância padrão do SQL Server em um servidor, especifique apenas o server_name. Para conectar-se a uma instância nomeada do SQL Server, especifique server_name\**instance_name.

-Ulogin_id
Especifica a ID de logon usada para conectar-se ao SQL Server.

Observação sobre segurança
Quando o utilitário bcp está se conectando ao SQL Server com uma conexão confiável usando segurança integrada, use a opção -T (conexão confiável) em vez da combinação user name e password.

-Ppassword
Especifica a senha para a ID de logon. Se essa opção não for usada, o comando bcp solicitará uma senha. Se essa opção for usada ao término do prompt de comando sem uma senha, o bcp usará a senha padrão (NULL).

Observação sobre segurança

Não use uma senha em branco. Use uma senha forte.

Para mascarar a senha, não especifique a opção -P junto com a opção -U. Em vez disso, depois de especificar o bcp junto com a opção -U e outras opções (não especificar -P), pressione ENTER, e o comando solicitará uma senha. Esse método garante que sua senha será mascarada quando for inserida.
-T
Especifica que o utilitário bcp conecta-se ao SQL Server com uma conexão confiável usando segurança integrada. As credenciais de segurança do usuário de rede, login_id e password, não são necessárias. Se –T não for especificada, será necessário especificar –U e –P para ter êxito no logon.
-v
Informa o número de versão e copyright do utilitário bcp.
-R
Especifica que dados de moeda, data e horário são copiados em massa no SQL Server usando o formato regional definido para as configurações de localidade do computador cliente. Por padrão, as configurações regionais são ignoradas.
-k
Especifica que colunas vazias devem reter um valor nulo durante a operação, em vez de qualquer valor padrão nas colunas inseridas. Para obter mais informações, consulte Mantendo valores nulos ou usando valores padrão durante a importação em massa.
-E
Especifica que o valor, ou valores, de identidade no arquivo de dados importado deve ser usado para a coluna de identidade. Se -E não for fornecido, os valores de identidade para essa coluna no arquivo de dados que está sendo importado serão ignorados e o SQL Server atribuirá automaticamente valores exclusivos com base nos valores semente e de incremento especificados durante a criação da tabela.

Se o arquivo de dados não contiver valores para a coluna de identidade na tabela ou exibição, use um arquivo de formato para especificar que a coluna de identidade na tabela ou exibição deve ser ignorada ao importar dados. O SQL Server atribui valores exclusivos para a coluna automaticamente. Para obter mais informações, consulte DBCC CHECKIDENT (Transact-SQL).

A opção -E tem um requisito de permissões especial. Para obter mais informações, consulte "Comentários" mais adiante neste tópico.

Para obter mais informações sobre como manter valores de identificação, consulte Mantendo valores de identidade ao importar em massa dados.
**-h"**hint[ ,... n] "
Especifica a dica ou dicas a serem usadas durante uma importação de dados em massa para uma tabela ou exibição.
- ORDER**(column[ASC | DESC] [,...n])**
  A ordem de classificação dos dados no arquivo de dados. O desempenho da importação em massa será melhorado se os dados importados forem armazenados de acordo com o índice clusterizado na tabela, se houver. Se o arquivo de dados for armazenado em uma ordem diferente, ou seja, distinta da ordem de uma chave de índice clusterizado, ou se não houver nenhum índice clusterizado na tabela, a cláusula ORDER será ignorada. Os nomes de coluna fornecidos devem ser nomes válidos na tabela de destino. Por padrão, bcp supõe que o arquivo de dados não esteja classificado. Para obter uma importação em massa otimizada, o SQL Server também valida que os dados importados sejam classificados.
  
  Para obter mais informações, consulte Controlando a ordem de classificação durante a importação em massa de dados.
- ROWS_PER_BATCH **=**bb
  Número de linhas de dados por lote (como bb). Usado quando -b não é especificado, resulta no envio de todo o arquivo de dados ao servidor como uma transação única. O servidor otimiza o carregamento em massa de acordo com o valor bb. Por padrão, ROWS_PER_BATCH é desconhecido.
  
  Para obter mais informações, consulte Gerenciando lotes para importar em massa.
- KILOBYTES_PER_BATCH = cc
  Número aproximado de quilobytes de dados por lote (como cc). Por padrão, KILOBYTES_PER_BATCH é desconhecido.
  
  Para obter mais informações, consulte Gerenciando lotes para importar em massa.
- TABLOCK
  Especifica que um bloqueio no nível de tabela de atualização em massa seja adquirido durante a operação de carregamento em massa, caso contrário, seja adquirido um bloqueio no nível de linha. Essa dica melhora significativamente o desempenho, pois manter um bloqueio durante a operação de cópia em massa reduz a contenção de bloqueio na tabela. Uma tabela pode ser carregada simultaneamente por vários clientes se não tiver nenhum índice e TABLOCK for especificado. Por padrão, o comportamento de bloqueio é determinado pela opção de tabela table lock on bulk load.
  
  Para obter mais informações, consulte Controlando o comportamento de bloqueio para a importação em massa.
- CHECK_CONSTRAINTS
  Especifica que todas as restrições na tabela ou exibição de destino devem ser verificadas durante a operação de importação em massa. Sem a dica CHECK_CONSTRAINTS, todas as restrições CHECK e FOREIGN KEY são ignoradas e, depois da operação, a restrição na tabela é marcada como não confiável.
  
  Observação
  
  As restrições UNIQUE, PRIMARY KEY e NOT NULL são sempre impostas.
  
  Em algum momento, você precisará verificar as restrições em toda a tabela. Se a tabela não estava vazia antes da operação de importação em massa, o custo de revalidação da restrição poderá exceder o custo da aplicação de restrições CHECK aos dados incrementais. Portanto, recomendamos que normalmente você habilite a verificação de restrições durante uma importação incremental em massa.
  
  Uma situação em que talvez convenha desabilitar as restrições (o comportamento padrão) é quando os dados de entrada contiverem linhas que violam restrições. Com as restrições CHECK desabilitadas, é possível importar os dados e usar instruções Transact-SQL para remover os dados inválidos.
  
  Observação
  
  Agora, o bcp impõe validação de dados e verificações de dados que podem provocar falhas em scripts se forem executados em dados inválidos em um arquivo de dados.
  
  Observação
  
  A opção -mmax_errors não se aplica à verificação de restrição.
  
  Para obter mais informações, consulte Controlando verificação de restrição por operações de importação em massa.
- FIRE_TRIGGERS
  Especificados com o argumento in, todos os gatilhos de inserção definidos na tabela de destino serão executados durante a operação de cópia em massa. Se FIRE_TRIGGERS não for especificado, nenhum gatilho de inserção será executado. FIRE_TRIGGERS é ignorado para os argumentos out, queryout e format.
  
  Para obter mais informações, consulte Controlando execução do gatilho ao importar dados em massa.

Observação sobre segurança
Não use uma senha em branco. Use uma senha forte.

Observação
As restrições UNIQUE, PRIMARY KEY e NOT NULL são sempre impostas.

Observação
Agora, o bcp impõe validação de dados e verificações de dados que podem provocar falhas em scripts se forem executados em dados inválidos em um arquivo de dados.

Observação
A opção -mmax_errors não se aplica à verificação de restrição.

Comentários

O cliente bcp 10.0 é instalado quando você instala as ferramentas do MicrosoftSQL Server 2008 em seu sistema. Se as ferramentas forem instaladas para o SQL Server 2008 e para uma versão anterior do SQL Server, dependendo do valor na variável do ambiente PATH, você poderá estar usando o cliente bcp anterior em vez do cliente bcp 10.0. Essa variável de ambiente define o conjunto de diretórios usado pelo Windows para procurar arquivos executáveis. Para descobrir qual versão você está usando, execute o comando bcp /v no prompt de comando do Windows. Para obter mais informações sobre como definir o caminho de comando na variável de ambiente PATH, consulte a Ajuda do Windows.

Os arquivos de formato XML só têm suporte quando as ferramentas do SQL Server são instaladas junto com o SQL Server Native Client.

Para obter informações sobre onde encontrar ou como executar o utilitário bcp e sobre as convenções de sintaxe dos utilitários de prompt de comando, consulte Utilitários do prompt de comando.

Para obter informações sobre como preparar dados para operações de importação ou exportação em massa, consulte Preparando dados para exportar ou importar em massa.

Para obter informações sobre quando as operações de inserção de linhas executadas por importações em massa são registradas no log de transações, consulte Pré-requisitos para log mínimo em importação em massa.

Suporte de arquivos de dados nativos

No SQL Server 2008, o utilitário bcp aceita apenas arquivos de dados nativos compatíveis com SQL Server 7.0, SQL Server 2000, SQL Server 2005 e SQL Server 2008. Arquivos de dados nativos do SQL Server6.0 e SQL Server 6.5 não são aceitos pelo SQL Server 2008.

Colunas computadas e colunas de carimbo de data/hora

Os valores no arquivo de dados que estão sendo importados para colunas computadas ou timestamp são ignorados e o SQL Server automaticamente atribui valores. Se o arquivo de dados não contiver valores para as colunas computadas ou de timestamp na tabela, use um arquivo de formato para especificar que as colunas computadas ou timestamp na tabela devem ser ignoradas na importação dados; o SQL Server automaticamente atribuirá valores para a coluna.

Colunas computadas e de timestamp são copiadas em massa do SQL Server em um arquivo de dados, como sempre.

Especificando identificadores que contêm espaços ou aspas

Os identificadores do SQL Server podem incluir caracteres, como espaços incorporados e aspas. Tais identificadores devem ser tratados do seguinte modo:

Quando você especificar um identificador ou nome de arquivo que inclua um espaço ou aspas no prompt de comando, coloque o identificador entre aspas ("").

Por exemplo, o comando bcp out a seguir cria um arquivo de dados nomeado Currency Types.dat:
```
bcp AdventureWorks.Sales.Currency out "Currency Types.dat" -T -c
```
Para especificar um nome de banco de dados que contenha um espaço ou aspas, você deve usar a opção -q.
Para nomes de proprietário, tabela ou exibição que contenham espaços incorporados ou aspas, você também pode:
- Especificar a opção -q ou
- Inserir o nome de proprietário, tabela ou exibição entre colchetes ([]) dentro das aspas.

Validação de dados

Agora, o bcp impõe validação de dados e verificações de dados que podem provocar falhas em scripts se forem executados em dados inválidos em um arquivo de dados. Por exemplo, o bcp agora verifica se:

A representação nativa de tipos de dados float ou real é válida.
Dados Unicode têm um comprimento regular de byte.

Formas de dados inválidos que podiam ser importadas em massa em versões anteriores do SQL Server podem falhar ao serem carregadas agora; enquanto em versões anteriores a falha só ocorria quando um cliente tentava acessar os dados inválidos. A validação adicional minimiza as surpresas ao consultar os dados depois do carregamento em massa.

Exportando ou importando documentos SQLXML em massa

Para exportar ou importar dados SQLXML em massa, use um dos tipos de dados a seguir em seu arquivo de formato.

Tipo de dados	Efeito
SQLCHAR ou SQLVARYCHAR	Os dados são enviados na página de código do cliente ou na página de código indicada pelo agrupamento. O efeito é o mesmo que especificar a opção -c sem especificar um arquivo de formato.
SQLNCHAR ou SQLNVARCHAR	Os dados são enviados como Unicode. O efeito é o mesmo que especificar a opção -w sem especificar um arquivo de formato.
SQLBINARY ou SQLVARYBIN	Os dados são enviados sem qualquer conversão.

Permissões

Uma operação bcp out requer permissão SELECT na tabela de origem.

Uma operação bcp in requer no mínimo permissões SELECT/INSERT na tabela de destino. Além disso, a permissão ALTER TABLE será necessária se qualquer das seguintes afirmações for verdadeira:

Existem restrições e a dica CHECK_CONSTRAINTS não foi especificada.

Observação

Desabilitar restrições é o comportamento padrão. Para habilitar restrições explicitamente, use a opção -h com a dica CHECK_CONSTRAINTS.
Existem gatilhos e a dica FIRE_TRIGGER não foi especificada.

Observação

Por padrão, os gatilhos não são disparados. Para disparar gatilhos explicitamente, use a opção -h com a dica FIRE_TRIGGERS.
Você usa a opção -E para importar valores de identidade de um arquivo de dados.

Observação
Desabilitar restrições é o comportamento padrão. Para habilitar restrições explicitamente, use a opção -h com a dica CHECK_CONSTRAINTS.

Observação
Por padrão, os gatilhos não são disparados. Para disparar gatilhos explicitamente, use a opção -h com a dica FIRE_TRIGGERS.

Observação
A exigência da permissão ALTER TABLE na tabela de destino era nova no SQL Server 2005. Essa nova exigência poderia fazer com que os scripts bcp que não impusessem verificações de gatilhos e de restrições falhassem se a conta do usuário não tivesse permissões ALTER TABLE para a tabela de destino.

Exemplos

Esta seção contém os seguintes exemplos:

A. Copiando linhas de tabela em um arquivo de dados (com uma conexão confiável)
B. Copiando linhas de tabela em um arquivo de dados (com autenticação mista)
C. Copiando dados de um arquivo em uma tabela
D. Copiando uma coluna específica em um arquivo de dados
E. Copiando uma linha específica em um arquivo de dados
F. Copiando dados de uma consulta em um arquivo de dados
G. Criando um arquivo de formato não XML
H. Criando um arquivo de formato XML
I. Usando um arquivo de formato para importação em massa com bcp

A. Copiando linhas de tabela em um arquivo de dados (com uma conexão confiável)

O exemplo a seguir ilustra a opção out na tabela AdventureWorks.Sales.Currency. Este exemplo cria um arquivo de dados denominado Currency.dat e copia os dados da tabela nesse arquivo usando formato de caractere. O exemplo presume que você esteja usando autenticação do Windows e tenha uma conexão confiável com a instância do servidor na qual está executando o comando bcp.

No prompt de comando, digite o seguinte comando:

bcp AdventureWorks.Sales.Currency out Currency.dat -T -c

B. Copiando linhas de tabela em um arquivo de dados (com autenticação mista)

O exemplo pressupõe que você esteja usando autenticação mista; você deve usar a opção -U para especificar sua ID de logon. Além disso, a menos que você esteja se conectando à instância padrão do SQL Server no computador local, use a opção -S para especificar o nome do sistema e, opcionalmente, um nome de instância.

bcp AdventureWorks.Sales.Currency out Currency.dat -c -U<login_id> -S<server_name\instance_name>

O sistema solicitará sua senha.

C. Copiando dados de um arquivo para uma tabela

O exemplo a seguir ilustra a opção in usando o arquivo criado no exemplo anterior (Currency.dat). Porém, primeiro este exemplo cria uma cópia vazia da tabela AdventureWorks Sales.Currency, Sales.Currency2, na qual os dados são copiados. O exemplo presume que você esteja usando autenticação do Windows e tenha uma conexão confiável com a instância do servidor na qual está executando o comando bcp.

Para criar a tabela vazia, execute o seguinte código no Editor de Consultas:

USE AdventureWorks;
GO
SELECT * INTO AdventureWorks.Sales.Currency2 
FROM AdventureWorks.Sales.Currency WHERE 1=2

Para copiar em massa os dados de caractere na nova tabela, isto é, para importar os dados, insira o comando a seguir no prompt de comando:

bcp AdventureWorks.Sales.Currency2 in Currency.dat -T -c

Para verificar se o comando teve sucesso, exiba o conteúdo da tabela no Editor de Consultas e digite:

USE AdventureWorks;
GO
SELECT * FROM Sales.Currency2

D. Copiando uma coluna específica em um arquivo de dados

Para copiar uma coluna específica, você pode usar a opção queryout. O exemplo a seguir copia apenas a coluna Name da tabela Sales.Currency em um arquivo de dados. O exemplo presume que você esteja usando autenticação do Windows e tenha uma conexão confiável com a instância do servidor na qual está executando o comando bcp.