Especificar formatos de dados para compatibilidade usando o bcp (SQL Server)

Aplica-se a: simSQL Server (todas as versões compatíveis) SimBanco de Dados SQL do Azure SimInstância Gerenciada do Azure SQL simAzure Synapse Analytics simParallel Data Warehouse

Este tópico descreve os atributos de formato de dados, avisos específicos de campo e armazenamento de dados campo por campo em um arquivo de formato não XML do comando SQL Serverbcp . Conhecê-los pode ser útil para exportar dados em massa do SQL Server para importação em massa para outro programa, como outro programa de banco de dados. Os formatos de dados padrão (nativo, caractere ou Unicode) na tabela de fonte poderiam ser incompatíveis com o layout de dados esperado por outro programa. Se uma incompatibilidade existir, quando você exportar os dados você deve descrever o layout dos dados.

Observação

Se você não estiver familiarizado com os formatos de dados para importar ou exportar dados, veja Formatos de dados para importação ou exportação em massa (SQL Server).

Atributos bcp Data-Format

O comando bcp permite especificar a estrutura de cada campo em um arquivo de dados quanto aos seguintes atributos de formato de dados:

  • tipo de armazenamento de arquivo

    O tipo de armazenamento de arquivo descreve como são armazenados os dados no arquivo de dados. Dados podem ser exportados para um arquivo de dados como seu tipo de tabela de banco de dados (formato nativo), em sua representação de caractere (formato de caractere) ou como qualquer tipo de dados em que há suporte para conversão implícita; por exemplo, copiando um smallint como um int. Os tipos de dados definidos pelo usuário como tipos básicos são exportados. Para obter mais informações, veja Especificar tipo de armazenamento de arquivo usando bcp (SQL Server).

  • Comprimento do prefixo

    Para fornecer o armazenamento de arquivos mais compacto para a exportação de dados em massa no formato nativo para um arquivo de dados, o comando bcp precede cada campo com um ou mais caracteres que indicam o comprimento do campo. Esses caracteres são chamados caracteres de prefixo de comprimento. Para obter mais informações, veja Especificar o tamanho de prefixo em arquivos de dados usando bcp (SQL Server).

  • Tamanho do campo

    O tamanho do campo indica o número máximo de caracteres que são exigidos para representar dados em formato de caractere. O tamanho do campo já é conhecido se os dados forem armazenados no formato nativo. Para obter mais informações, veja Especificar tamanho do campo usando bcp (SQL Server).

  • Terminador de campo

    Para campos de dados de caractere, caracteres terminadores opcionais permitem marcar o término de cada campo em um arquivo de dados (usando um terminador de campo) e o término de cada linha (usando um terminador de linha). Os caracteres terminadores são um modo de indicar aos programas de leitura o arquivo de dados onde um campo ou uma linha termina, e a outra começa. Para obter mais informações, veja Especificar terminadores de campo e linha (SQL Server).

Visão geral dos prompts de campo específicos

Se um comando bcp interativo contiver a opção in ou out , mas também não contiver a opção de arquivo de formato ( -f) ou uma opção de formato de dados ( -n, -c, -w ou -N), cada coluna na tabela de destino ou origem, o comando solicitará cada um dos atributos precedentes, por vez. Em cada prompt, o comando bcp fornece um valor padrão baseado no tipo de dados do SQL Server da coluna de tabela. Aceitar o valor padrão de todos os prompts gera o mesmo resultado de especificar o formato nativo ( -n) na linha de comando. Cada prompt exibe um valor padrão entre colchetes: [default]. Pressionando ENTER aceita o padrão exibido. Para especificar um valor diferente do padrão, insira o valor novo no prompt.

Exemplo

Os exemplos a seguir usam o comando bcp para exportar em massa dados da tabela HumanResources.myTeam para o arquivo myTeam.txt interativamente. Antes de executar o exemplo, é necessário criar essa tabela. Para obter informações sobre a tabela e como criá-la, veja Tabela de exemplo HumanResources.myTeam (SQL Server).

O comando não especifica nem um arquivo de formato nem um tipo de dados, fazendo com que o bcp solicite informações de formato de dados. No prompt de comando do Microsoft Windows, digite:

bcp AdventureWorks.HumanResources.myTeam out myTeam.txt -T  

Para cada coluna, o bcp solicita os valores de campo específicos. O exemplo seguinte mostra os prompts de campo especifico para as colunas EmployeeID e Name da tabela e sugere o tipo de armazenamento de arquivo padrão (o formato nativo) para cada coluna. Os comprimentos dos prefixos do EmployeeID e coluna Name são 0 e 2, respectivamente. O usuário especifica uma vírgula (,) como terminador de cada campo.

Enter the file storage type of field EmployeeID [smallint]:

Enter prefix-length of field EmployeeID [0]:

Enter field terminator [none]:,

Enter the file storage type of field Name [nvarchar]:

Enter prefix length of field Name [2]:

Enter field terminator [none]:,

.

.

.

São exibidos prompts equivalentes (quando necessário) para cada uma das colunas de tabela em ordem.

Armazenando dados campo por campo em um arquivo de formato não XML

Após todas as colunas de tabela serem especificadas, o comando bcp solicita que você gere um arquivo de formato não XML que armazena a informações campo por campo fornecidas (veja o exemplo anterior) opcionalmente. Se você escolher gerar um arquivo de formato, você poderá sempre que exportar dados fora daquela tabela ou importar dados estruturados em SQL Server.

Observação

Você pode usar o arquivo de formato para importação em massa de um arquivo de dados em uma instância SQL Server para exportar dados em massa da tabela sem precisar especificar o formato. Para obter mais informações, consulte Arquivos de formato para importação ou exportação de dados (SQL Server).

O exemplo a seguir cria um arquivo de formato nomeado não XML myFormatFile.fmt:

Do you want to save this format information in a file? [Y/n] y

Host filename: [bcp.fmt]myFormatFile.fmt

O nome padrão para o arquivo de formato é bcp.fmt, mas você poderá especificar um nome de arquivo diferente se você preferir.

Observação

Para um arquivo de dados que usa um único formato de dados para seu tipo de armazenamento de arquivos, como caractere ou formato nativo, você pode criar um arquivo de formato rapidamente sem exportar ou importar dados usando a opção format . Esta abordagem tem a vantagem de ser fácil e de lhe permitir criar um arquivo formato XML ou um não XML. Para obter mais informações, consulte Criar um arquivo de formato (SQL Server).

Nenhum.

Consulte Também

Importação e exportação em massa de dados (SQL Server)
Formatos de dados para importação ou exportação em massa (SQL Server)
Utilitário bcp
Tipos de dados (Transact-SQL)