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

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure Synapse AnalyticsPDW (Analytics Platform System)Banco de Dados SQL no Microsoft Fabric

Este artigo descreve os atributos de formato de dados, os avisos específicos de campo e como armazenar dados campo a campo em um arquivo de formato não XML do utilitário bcp. Essas informações podem ajudar quando você exporta em massa dados do SQL Server para importação em massa em outro programa, como outro programa de banco de dados. Os formatos de dados padrão (nativo, de caracteres ou Unicode) na tabela de origem podem ser incompatíveis com o layout de dados que o outro programa espera. Se existir uma incompatibilidade, você deve descrever o layout dos dados ao exportar os dados.

Atributos do formato de dados BCP

Use bcp para especificar a estrutura de cada campo em um arquivo de dados por meio dos 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. Você pode exportar dados para um arquivo de dados como seu tipo de tabela de banco de dados (formato nativo), em sua representação de caracteres (formato de caractere), ou como qualquer tipo de dado que suporte conversão implícita. Por exemplo, você pode copiar um smallint como um int. Tipos de dados definidos pelo usuário são exportados como seus tipos base. Para mais informações, veja Especificar tipo de armazenamento de arquivo usando bcp.

• Comprimento do prefixo

  Para fornecer o armazenamento de arquivos mais compacto possível para a exportação em massa de dados em formato nativo para um arquivo de dados, bcp cada campo é precedido por um ou mais caracteres que indicam o comprimento do campo. Esses caracteres são chamados caracteres de prefixo de comprimento. Para mais informações, veja Especificar comprimento de prefixo em arquivos de dados usando bcp.

• 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 mais informações, veja Especificar comprimento de campo usando bcp.

• Terminador de campo

  Para campos de dados de caracteres, caracteres terminantes opcionais permitem marcar o fim de cada campo em um arquivo de dados (usando um terminador de campo) e o final 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, consulte Especificar terminadores de campo e linha.

Visão geral dos prompts específicos de cada área

Se você executar bcp interativamente com a opção in ou out, mas não incluir nem a opção de arquivo de formato (-f) nem uma opção de formato de dados (-n, -c, -w ou -N) para cada coluna na tabela de origem ou de destino, bcp solicitará cada um dos atributos anteriores, um por vez. Em cada prompt, bcp fornece um valor padrão baseado no tipo de dado do SQL Server da coluna da tabela. Aceitar o valor padrão para todos os prompts produz o mesmo resultado que especificar o formato nativo (-n) na linha de comando. Cada prompt exibe um valor padrão entre colchetes: [default]. Pressione ENTER para aceitar o padrão exibido. Para especificar um valor diferente do padrão, insira o valor novo no prompt.

Exemplo

O exemplo a seguir usa bcp para exportar dados em massa da tabela HumanResources.myTeam de forma interativa para o arquivo myTeam.txt. Antes de executar o exemplo, é necessário criar essa tabela. Para informações sobre a tabela e como criá-la, veja Tabela de Exemplo HumanResources.myTeam.

O comando não especifica nem um arquivo de formato nem um tipo de dado, então bcp solicita informações sobre o formato dos dados. No prompt de comando do Windows, digite:

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

Para cada coluna, bcp solicita valores específicos para cada campo. 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 das EmployeeID colunas e 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]:,

.

.

.

Prompts equivalentes aparecem conforme necessário para cada coluna da tabela, em ordem.

Armazene os dados campo a campo em um arquivo que não é em formato XML

Depois de especificar todas as colunas da tabela, bcp solicita que você gere opcionalmente um arquivo em formato não XML que armazene as informações campo por campo que você acabou de fornecer (veja o exemplo anterior). Se você escolher gerar um arquivo de formatação, pode usá-lo sempre que exportar dados dessa tabela ou importar dados estruturados semelhantes para o 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 do arquivo de formato é bcp.fmt, mas você pode especificar um nome diferente se quiser.

Tarefas relacionadas

• Especifique o tipo de armazenamento de arquivo usando bcp
• Especificar o comprimento do prefixo em arquivos de dados usando bcp
• Especifique o comprimento do campo usando bcp
• Especificar terminadores de campo e de linha

Conteúdo relacionado

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