Utilitário bcp

O utilitário bcp copia dados em massa entre uma instância do Microsoft SQL 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 para 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 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.

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 de seus dados, crie um arquivo de formato para registrar o formato dos dados. Os arquivos de dadosbcp não incluem quaisquer informações de esquema ou de formato. Portanto, se uma tabela ou exibição for descartada e você 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" {indata_file | outdata_file | queryoutdata_file | format nul}  
  
[-apacket_size]  
[-bbatch_size]  
[-c]  
[-C { ACP | OEM | RAW | code_page } ]  
[-ddatabase_name]  
[-eerr_file]  
[-E]  
[-fformat_file]  
[-Ffirst_row]  
[-h"hint [,...n]"]   
[-iinput_file]  
[-k]  
[-Kapplication_intent]  
[-Llast_row]  
[-mmax_errors]  
[-n]  
[-N]  
[-ooutput_file]  
[-Ppassword]  
[-q]  
[-rrow_term]  
[-R]  
[-S [server_name[\instance_name]]  
[-tfield_term]  
[-T]  
[-Ulogin_id]  
[-v]  
[-V (80 | 90 | 100 | 110)]  
[-w]  
[-x]  
/?  

Argumentos

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 2⁶³ – 1 linhas.

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.

Você também pode especificar explicitamente o nome de banco de dados com d-.

em data_file | foradata_file | queryoutdata_file | formato nul
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 deve ser especificado somente quando você copiar dados em massa de uma consulta.

• format cria um arquivo de formato com base na opção especificada (-n, -c, -wou -N) e nos delimitadores de tabela ou exibição. Quando você copia dados em massa, o comando bcp pode recorrer a um arquivo de formato, o que libera você da necessidade de inserir novamente as informações de formato de forma interativa. A opção format exige a opção -f ; a criação de um arquivo de formato XML também exige a opção -x . Para obter mais informações, confira Criar um arquivo de formato (SQL Server). É necessário especificar nul como o valor (format nul).

owner
Corresponde ao nome do proprietário da tabela ou exibição. Oowner será opcional se o usuário que estiver executando a operação for o proprietário da tabela ou exibição especificada. Se o proprietário não for especificado e o usuário que executa a operação não for o proprietário da tabela ou exibição especificada, o SQL Server retornará uma mensagem de erro e a operação será cancelada.

" consulta "
É uma consulta Transact-SQL que retorna um conjunto de resultados. Se a consulta retornar vários conjuntos de resultados, somente o primeiro conjunto de resultados será copiado no arquivo de dados; os conjuntos de resultados subsequentes serão ignorados. Coloque a consulta entre aspas duplas e qualquer coisa incorporada na consulta entre aspas simples. queryout também deve 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 durante o 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, use bcp para copiar os dados da tabela em um arquivo de dados.

table_name
Nome da tabela de destino ao importar dados para o SQL Server (in) e da tabela de origem ao exportar dados do SQL Server (out).

view_name
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, confira INSERT (Transact-SQL).

-a packet_size
Especifica o número de bytes por pacote de rede enviado de e para o servidor. Uma opção de configuração de servidor pode ser definida usando 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 estar entre 4096 a 65535 bytes, sendo 4096 o padrão.

Um tamanho de pacote maior pode aumentar o desempenho de operações de cópia em massa. Se um pacote maior for pedido 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.

-b batch_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 do que o número de linhas no arquivo de dados. Se a transação apresentar falha para qualquer lote, só serão revertidas as inserções do lote atual. Lotes já importados por transações confirmadas não serão afetados por uma falha posterior.

Não use esta opção em conjunto com a opção **-h"**ROWS_PER_BATCH =bb".

-c
Executa a operação usando um tipo de dados de caractere. Essa opção não solicita cada campo; Ele usa char como o tipo de armazenamento, sem prefixos e com \t (caractere de tabulação) como separador de campo e \r\n (caractere de nova linha) como o terminador de linha. -c não é compatível com -w.

Para obter mais informações, confira Usar o formato de caractere para importar ou exportar dados (SQL Server).

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

Observação

Recomendamos que você especifique um nome de ordenação 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 acontece 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 dá suporte à página de código 65001 (codificação UTF-8).

-ddatabase_name
Especifica o banco de dados que deve ser conectado. Por padrão, bcp.exe se conecta ao banco de dados padrão do usuário. Se -ddatabase_name e um nome de três partes (database_name.schema.table, passado como o primeiro parâmetro para bcp.exe) for especificado, ocorrerá um erro porque você não pode especificar o nome do banco de dados duas vezes. Se database_name começar com um hífen (-) ou uma barra (/), não adicione um espaço entre -d e o nome do banco de dados.

-e err_file
Especifica o caminho completo de um arquivo de erro usado para armazenar as linhas que o utilitário bcp não pode 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.

Se err_file começar com um hífen (-) ou uma barra (/), não inclua um espaço entre -e e o valor err_file .

-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, confira 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.

-f format_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, confira Criar um arquivo de formato (SQL Server).

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

  Observação

  O uso de um arquivo de formato com a opção in ou out é opcional. Na ausência da opção -f , se -n, -c, -wou -N não for especificado, 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).

Se format_file começar com um hífen (-) ou uma barra (/), não inclua um espaço entre -f e o valor format_file .

-F first_row
Especifica o número da primeira linha que deve ser exportada de uma tabela ou importada de um arquivo de dados. Esse parâmetro requer um valor superior a (>) 0, mas inferior (<) 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.

-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.

ORDEM**(coluna[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 das colunas fornecidos devem ser nomes de colunas válidas na tabela de destino. Por padrão, o bcp supõe que o arquivo de dados não está classificado. Para obter uma importação em massa otimizada, o SQL Server também valida que os dados importados sejam classificados.

ROWS_PER_BATCH =bb
Número de linhas de dados por lote (como bb). É usado quando -b não é especificado, resultando 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.

= KILOBYTES_PER_BATCH cc
Número aproximado de kilobytes de dados por lote (como cc). Por padrão, KILOBYTES_PER_BATCH é desconhecido.

TABLOCK
Especifica que um bloqueio no nível de tabela de atualização em massa é adquirido durante a operação de carregamento em massa, caso contrário, um bloqueio no nível de linha é adquirido. Essa dica melhora significativamente o desempenho porque manter um bloqueio durante a operação de cópia em massa reduz a contenção de bloqueios na tabela. Uma tabela pode ser carregada simultaneamente através de 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 bloqueio de tabela em carregamento 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 na qual talvez você queira desabilitar as restrições (o comportamento padrão) é quando os dados de entrada contiverem linhas que violam as 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, obcp 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 -m max_errors não se aplica à verificação de restrição.

FIRE_TRIGGERS
Especificado 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, queryoute format .

-i input_file
Especifica o nome de um arquivo de resposta, contendo as respostas às perguntas do prompt de comando para cada campo de dados quando uma cópia em massa está sendo executada usando o modo interativo (-n, -c, -wou -N não especificado).

Se input_file começar com um hífen (-) ou uma barra (/), não inclua um espaço entre -i e o valor input_file .

-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, confira Manter valores nulos ou usar os valores padrão durante a importação em massa (SQL Server).

-K application_intent
Declara o tipo de carga de trabalho de aplicativo ao conectar-se a um servidor. O único valor possível é ReadOnly. Se -K não for especificado, o utilitário bcp não oferecerá suporte à conectividade a uma réplica secundária em um grupo de disponibilidade AlwaysOn. Para obter mais informações, consulte Secundários ativos: réplicas secundárias legíveis (Grupos de Disponibilidade AlwaysOn).

-L last_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 superior (>) 0, mas inferior (<) 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.

-m max_errors
Especifica o número máximo de erros de sintaxe que podem ocorrer antes que a operação bcp seja cancelada. Um erro de sintaxe implica em um erro de conversão de dados para o tipo de dados de destino. O total de max_errors exclui todos os erros que podem ser detectados apenas 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 dos money tipos de dados or bigint .

-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, confira Usar o formato nativo para importar ou exportar dados (SQL Server).

-N
Executa a operação de cópia em massa usando os tipos de dados nativos (banco de dados) dos dados para dados de não caractere e caracteres Unicode para dados de caractere. 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 ANSI estendidos e quiser aproveitar o desempenho do modo nativo.

Para obter mais informações, confira Usar o formato nativo Unicode para importar ou exportar dados (SQL Server).

Se você exportar e importar dados para o mesmo esquema de tabela usando 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 pode ser ignorado. Uma maneira de resolver este aviso é usar -n em vez de -N.

-o output_file
Especifica o nome de um arquivo que recebe a saída redirecionada do prompt de comando.

Se output_file começar com um hífen (-) ou uma barra (/), não inclua um espaço entre -o e o valor output_file .

-P password
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).

Importante

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

Para mascarar a senha, não especifique a opção -P juntamente 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.

Se password começar com um hífen (-) ou uma barra (/), não adicione um espaço entre -P e o valor password .

-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.

-q não se aplica a valores passados para -d.

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

-r row_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, confira Especificar terminadores de campo e linha (SQL Server).

Se você especificar o terminador de linha em notação hexadecimal em um comando bcp.exe, o valor será truncado em 0x00. Por exemplo, se você especificar 0x410041, 0x41 será usado.

Se row_term começar com um hífen (-) ou uma barra (/), não inclua um espaço entre -r e o valor row_term .

-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.

-S server_name[ \instance_name]
Especifica a instância do SQL Server à qual você deseja 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 é requerida 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 server_name. Para se conectar a uma instância nomeada do SQL Server, especifique server_name*\*instance_name.

-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, confira Especificar terminadores de campo e linha (SQL Server).

Se você especificar o terminador de campo em notação hexadecimal em um comando bcp.exe, o valor será truncado em 0x00. Por exemplo, se você especificar 0x410041, 0x41 será usado.

Se field_term começar com um hífen (-) ou uma barra (/), não inclua um espaço entre -t e o valor field_term .

-T
Especifica que o utilitário bcp se conecta ao SQL Server com uma conexão confiável usando segurança integrada. As credenciais de segurança do usuário de rede, login_ide password não são necessárias. Se -T não for especificado, será necessário especificar -U e -P para que o logon tenha êxito.

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

Importante

Quando o utilitário bcp estiver 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 .

-v
Relata o número de versão e os direitos autorais do utilitário bcp .

-V (80 | 90 | 100| 110)
Executa a operação de cópia em massa usando 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.

80 = SQL Server 2000

90 = SQL Server 2005

100 = SQL Server 2008 e SQL Server 2008 R2

110 = SQL Server 2012

Por exemplo, para gerar dados para tipos não suportados pelo SQL Server 2000, mas que foram introduzidos em versões posteriores do SQL Server, use a opção -V80.

Para obter mais informações, consulte Importar dados de formato de caractere e nativo de versões anteriores do SQL Server.

-w
Executa a operação de cópia em massa usando caracteres Unicode. Essa opção não solicita cada campo; Ele usa nchar como tipo de armazenamento, sem prefixos, \t (caractere de tabulação) como separador de campo e \n (caractere de nova linha) como terminador de linha. -w não é compatível com -c.

Para obter mais informações, confira Usar o formato de caractere Unicode para importar ou exportar dados (SQL Server).

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

Comentários

O cliente bcp 12.0 é instalado quando você instala as ferramentas do MicrosoftSQL Server 2014. Se as ferramentas estiverem instaladas para o SQL Server 2014 e uma versão anterior do SQL Server, dependendo do valor da variável de ambiente PATH, você poderá estar usando o cliente bcp anterior em vez do cliente bcp 12.0. Essa variável de ambiente define o conjunto de diretórios usado pelo Windows para pesquisar por 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 mais 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, confira Referência de utilitário de linha de comando (Mecanismo de Banco de Dados).

Para obter informações sobre como preparar dados para importar ou exportar operações em massa, confira Preparar dados para exportar ou importar em massa (SQL Server).

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, veja Pré-requisitos para log mínimo em importação em massa.

Suporte de arquivos de dados nativos

No SQL Server 2014, o utilitário bcp dá suporte a arquivos de dados nativos compatíveis com SQL Server 2000, SQL Server 2005, SQL Server 2008, SQL Server 2008 R2 e SQL Server 2012.

Colunas computadas e colunas de carimbo de data/hora

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

As colunas computadas e timestamp as colunas são copiadas em massa do SQL Server para um arquivo de dados, como de costume.

Especificando identificadores que contêm espaços ou aspas

SQL Server podem incluir caracteres como espaços inseridos 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 AdventureWorks2012.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 inseridos 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, obcp 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 implicada pela ordenação. 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 bcpout exige a permissão SELECT na tabela de origem.

Uma operação bcpin exige, no mínimo, as 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.

• Use a opção -E para importar valores de identidade de um arquivo de dados.

Observação

A exigência da permissão ALTER TABLE na tabela de destino era nova no SQL Server 2005. Essa nova exigência pode provocar falha em scripts bcp que não impõem verificações de gatilhos e de restrições se a conta do usuário não tiver permissões ALTER TABLE para a tabela de destino.

Práticas recomendadas de modo de caractere (-c) e modo nativo (-n)

Esta seção apresenta recomendações para modo de caractere (-c) e modo nativo (-n).

• (Administrador/Usuário) Quando possível, use o formato nativo (-n) para evitar o problema de separador. Use o formato nativo para exportar e importar com o uso do SQL Server. Exporte dados do SQL Server com o uso da opção -c ou -w se os dados serão importados para um banco de dados doSQL Server .

• (Administrador) Verifique dados ao usar BCP OUT. Por exemplo, quando você usa BCP OUT, BCP IN e, em seguida, BCP OUT, verifique se os dados são exportados corretamente e se os valores de terminador não são usados como parte de algum valor de dados. Considere substituir os terminadores padrão (com as opções -t e -r) com valores hexadecimais aleatórios para evitar conflitos entre valores de terminadores e os valores de dados.

• (Usuário) Use um terminador longo e exclusivo (qualquer sequência de bytes ou de caracteres) para minimizar a possibilidade de um conflito com o valor da cadeia de caracteres real. Isso pode ser feito com as opções -t e -r.

Exemplos

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

• R. 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

R. 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 AdventureWorks2012.Sales.Currency . Este exemplo cria um arquivo de dados nomeado Currency.dat e copia os dados da tabela nesse arquivo usando formato de caractere. O exemplo presume que você esteja usando a 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 AdventureWorks2012.Sales.Currency out Currency.dat -T -c  

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

O exemplo a seguir ilustra a opção out na tabela AdventureWorks2012.Sales.Currency . Este exemplo cria um arquivo de dados nomeado Currency.dat e copia os dados da tabela nesse arquivo usando formato de caractere.

O exemplo pressupõe que você esteja usando autenticação mista; é necessário 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 AdventureWorks2012.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 em 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 AdventureWorks2012 Sales.Currency, Sales.Currency2 na qual os dados são copiados. O exemplo presume que você esteja usando a 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 AdventureWorks2012;  
GO  
SELECT * INTO AdventureWorks2012.Sales.Currency2   
FROM AdventureWorks2012.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 AdventureWorks2012.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 AdventureWorks2012;  
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 a 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 do Windows, digite:

bcp "SELECT Name FROM AdventureWorks.Sales.Currency" queryout Currency.Name.dat -T -c  

E. Copiando uma linha específica em um arquivo de dados

Para copiar uma linha específica, você pode usar a opção queryout . O exemplo a seguir copia somente a linha do contato chamado Jarrod Rana da tabela AdventureWorks2012.Person.Person em um arquivo de dados (Jarrod Rana.dat). O exemplo presume que você esteja usando a 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 do Windows, digite:

bcp "SELECT * FROM AdventureWorks2012.Person.Person WHERE FirstName='Jarrod' AND LastName='Rana' "  queryout "Jarrod Rana.dat" -T -c  

F. Copiando dados de uma consulta em um arquivo de dados

Para copiar o conjunto de resultados de uma instrução Transact-SQL em um arquivo de dados, use a opção queryout . O exemplo a seguir copia os nomes da tabela AdventureWorks2012.Person.Person , classificados pelo sobrenome e depois pelo prenome, no arquivo de dados Contacts.txt . O exemplo presume que você esteja usando a 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 do Windows, digite:

bcp "SELECT FirstName, LastName FROM AdventureWorks2012.Person.Person ORDER BY LastName, Firstname" queryout Contacts.txt -c -T  

G. Criando um arquivo de formato não XML

O exemplo a seguir cria um arquivo de formato não XML, Currency.fmt, para a Sales.Currency tabela no banco de dados AdventureWorks2012 . O exemplo presume que você esteja usando a 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 do Windows, digite:

bcp AdventureWorks2012.Sales.Currency format nul -T -c  -f Currency.fmt  

Para obter mais informações, veja Arquivos de formato não XML (SQL Server).

H. Criando um arquivo de formato XML

O exemplo a seguir cria um arquivo de formato XML nomeado Currency.xml para a Sales.Currency tabela no banco de dados AdventureWorks2012 . O exemplo presume que você esteja usando a 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 do Windows, digite:

bcp AdventureWorks2012.Sales.Currency format nul -T -c -x -f Currency.xml  

Observação

Para usar a opção -x , é necessário estar usando um cliente bcp 9.0. Para saber mais sobre como usar o cliente bcp 9.0, consulte "Comentários".

Para obter mais informações, veja Arquivos de formato XML (SQL Server).

I. Usando um arquivo de formato para importação em massa com bcp

Para usar um arquivo de formato criado anteriormente ao importar dados para uma instância do SQL Server, use a opção -f com a opção in . Por exemplo, o comando a seguir copia em massa os conteúdos de um arquivo de dados, Currency.dat, em uma cópia da tabela Sales.Currency (Sales.Currency2) usando o arquivo de formato criado anteriormente (Currency.xml). O exemplo presume que você esteja usando a 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 do Windows, digite:

bcp AdventureWorks2012.Sales.Currency2 in Currency.dat -T -f Currency.xml  

Observação

Os arquivos de formato são úteis quando os campos do arquivo de dados são diferentes das colunas da tabela, por exemplo, em seu número, classificação ou tipos de dados. Para obter mais informações, confira Arquivos de formato para importação ou exportação de dados (SQL Server).

Exemplos adicionais

Os tópicos a seguir contêm exemplos sobre como usar o bcp:

• Criar um formato de arquivo (SQL Server)

• Exemplos de importação e exportação em massa de documentos XML (SQL Server)

• Manter valores de identidade ao importar dados em massa (SQL Server)

• Manter valores nulos ou use os valores padrão durante a importação em massa (SQL Server)

• Especificar terminadores de campo e linha (SQL Server)

• Usar um arquivo de formato para importação em massa de dados (SQL Server)

• Usar o formato de caractere para importar ou exportar dados (SQL Server)

• Usar um formato nativo para importar ou exportar dados (SQL Server)

• Usar o formato de caractere Unicode para importar ou exportar dados (SQL Server)

• Usar o formato nativo Unicode para importar ou exportar dados (SQL Server)

Confira também

Preparar dados para exportação ou importação em massa (SQL Server)
BULK INSERT (Transact-SQL)
OPENROWSET (Transact-SQL)
SET QUOTED_IDENTIFIER (Transact-SQL)
sp_configure (Transact-SQL)
sp_tableoption (Transact-SQL)
Arquivos de formato para importação ou exportação de dados (SQL Server)