Exportar (0) Imprimir
Expandir Tudo
Este artigo foi traduzido manualmente. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original

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.

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

bcp [database_name.] schema.{table_name | view_name | "query" {in data_file | out data_file | queryout data_file | format nul}

   [-a packet_size]
   [-b batch_size]
   [-c]
   [-C { ACP | OEM | RAW | code_page } ]
   [-d database_name]
   [-e err_file]
   [-E]
   [-f format_file]
   [-F first_row]
   [-h"hint [,...n]"] 
   [-i input_file]
   [-k]
   [-K application_intent]
   [-L last_row]
   [-m max_errors]
   [-n]
   [-N]
   [-o output_file]
   [-P password]
   [-q]
   [-r row_term]
   [-R]
   [-S [server_name[\instance_name]]
   [-t field_term]
   [-T]
   [-U login_id]
   [-v]
   [-V (80 | 90 | 100 | 110)]
   [-w]
   [-x]
   /?

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.

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

in data_file | outdata_file | queryoutdata_file | format 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 em 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, -w ou -N) e nos delimitadores da tabela ou exibição. Quando você copia dados em massa, o comando bcp pode recorrer a um arquivo de formato, o que o libera de redigitar interativamente as informações de formato. 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 Criar um formato de arquivo (SQL Server). Você deve especificar nul como o valor (format nul).

owner

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

" query "

É 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 valor inserido 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

É o 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

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

-a packet_size

Especifica o número de bytes por pacote de rede enviado de e para o servidor. A opção de configuração do 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 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 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 essa opção junto 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 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. -c não é compatível com -w.

Para obter mais informações, consulte 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 é relevante somente se os dados contiverem colunas char, varchar ou text com valores de caracteres superiores a 127 ou inferiores a 32.

Observação 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 acontece nenhuma conversão.

code_page

Um número de página de código específico, por exemplo, 850.

Observação importante Importante

O SQL Server não dá suporte à página de código 65001 (codificação UTF-8).

-d database_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, transmitidos como o primeiro parâmetro para bcp.exe) forem especificados, ocorrerá um erro porque você não pode especificar o nome do banco de dados duas vezes. Se database_name começar com hífen (-) ou barra (/), não adicione 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 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.

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

-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 é 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 Criar um formato de arquivo (SQL Server).

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

    Observação Observação

    É opcional usar um arquivo de formato in com a opção in ou out. Na ausência da opção -f, se -n, -c, -w ou -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 maior do que (>) 0, mas menor do 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. -F first_row é de base 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.

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 das colunas fornecidos devem ser nomes de colunas válidas na tabela de destino. Por padrã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, 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.

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

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 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 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 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, queryout e format.

-i input_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 está sendo executada com o uso do modo interativo (-n, -c, -w ou -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, consulte Manter valores nulos ou use 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árias ativas: 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 maior do que (>) 0, mas menor do 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.

-m max_errors

Especifica o número máximo de erros de sintaxe que podem ocorrer antes da operação bcp ser cancelada. Um erro de sintaxe implica em um erro de conversão de dados para o 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 Observação

A opção -m também não se aplica à conversão de tipos de dados money ou 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, consulte 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, consulte Usar o formato nativo Unicode para importar ou exportar dados (SQL Server).

Se você exportar e depois importar dados no mesmo esquema de tabela usando bcp.exe com -N, talvez seja exibido 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. Um modo 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).

Observação sobre segurança 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 pedirá 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 posteriormente 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, consulte 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 uma instância do SQL Server à qual se conectar. Se nenhum servidor for especificado, o utilitário bcp irá 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 o server_name. Para conectar-se a uma instância nomeada do SQL Server, especifique server_name\instance_name.

-t field_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 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_id e password não são necessárias. Se –T não for especificado, especifique –U e –P para o logon ser efetuado com êxito.

-U login_id

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

Observação sobre segurança Observação sobre segurança

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

Informa o número de versão e copyright 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 and SQL Server 2008 R2

110 = SQL Server 2012

Por exemplo, para gerar dados para tipos sem suporte no SQL Server 2000, mas que foram incorporados nas 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 o preenchimento de cada campo; ela usa nchar como tipo de armazenamento, sem prefixos, \t (caractere de tabulação) como separador de campos e \n (caractere de nova linha) como terminador de linha. -w não é compatível com -c.

Para obter mais informações, consulte 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.

O cliente bcp 12.0 é instalado quando você instala as ferramentas do Microsoft SQL Server 2014. Se as ferramentas forem instaladas para o SQL Server 2014 e para uma versão anterior do SQL Server, dependendo do valor na 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 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 Referência de utilitários de prompt de comando (Mecanismo de Banco de Dados).

Para obter informações sobre como preparar dados para operações de importação ou de exportação em massa, consulte 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, consulte 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 oferece suporte somente 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 sendo para computado ou colunas 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 de timestamp na tabela, use um arquivo de formato para especificar que as colunas computadas ou de timestamp na tabela devem ser ignoradas ao importar 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 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, 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 implicada 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.

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

Uma operação bcpin 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 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 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 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.

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

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 importar dados 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 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 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; 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 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 precedente (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 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 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 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 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 tabela Sales.Currency no banco de dados AdventureWorks2012 . 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 do Windows, digite:

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

Para obter mais informações, consulte 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 tabela Sales.Currency no banco de dados AdventureWorks2012 . 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 do Windows, digite:

bcp AdventureWorks2012.Sales.Currency format nul -T -c -x -f Currency.xml
ObservaçãoObservação

Para usar a opção -x, você deve estar usando um cliente bcp 9.0. Para obter informações sobre como usar o cliente bcp 9.0, consulte "Comentários".

Para obter mais informações, consulte 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 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çãoObservaçã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, consulte Arquivos de formato para importação ou exportação de dados (SQL Server).

Contribuições da comunidade

ADICIONAR
Mostrar:
© 2014 Microsoft