Partilhar via


Arquivos de formato para importação ou exportação de dados (SQL Server)

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure PDW (Analytics Platform System)

Na importação de dados em massa para uma tabela do SQL Server ou na exportação em massa de dados de uma tabela, você pode usar um arquivo de formato para armazenar todas as informações necessárias para exportar ou importar dados em massa. Isso inclui informações de formato para cada campo em um arquivo de dados relativo para essa tabela.

O SQL Server dá suporte a dois tipos de arquivos de formato: arquivos de formato XML e não XML. Os arquivos de formato XML e não XML contêm descrições de cada campo de um arquivo de dados, e arquivos de formato XML também contêm descrições das colunas das tabelas correspondentes. Geralmente, arquivos de formato XML e não XML são intercambiáveis. Entretanto, recomendamos que você use a sintaxe XML para novos arquivos de formato porque eles oferecem diversas vantagens em relação aos arquivos de formato não XML. Para obter mais informações, veja Arquivos de formato XML (SQL Server).

Observação

Essa sintaxe, incluindo inserção em massa, não tem suporte no Azure Synapse Analytics. No Azure Synapse Analytics e em outras integrações de plataforma de banco de dados de nuvem, efetue a movimentação de dados por meio da instrução COPY no Azure Data Factory ou usando instruções T-SQL, como COPY INTO e PolyBase.

Benefícios de arquivos de formato

Os arquivos de formato fornecem um sistema flexível para registrar arquivos de dados que requer pouca ou nenhuma edição para estar em conformidade com outros formatos de dados ou para ler arquivos de dados de outros programas de software.

Você pode importar dados em massa sem precisar adicionar ou excluir dados desnecessários ou reordenar dados existentes no arquivo de dados. Os arquivos de formato podem ser úteis quando existe uma incompatibilidade entre campos no arquivo de dados e as colunas na tabela.

Exemplos de arquivos de formato

Os exemplos abaixo mostram o layout de um arquivo de formato não XML e de um arquivo de formato XML. Esses arquivos de formato correspondem à tabela HumanResources.myTeam no banco de dados de exemplo AdventureWorks2022 . Essa tabela contém quatro colunas: EmployeeID, Name, Titlee ModifiedDate.

Observação

Para obter informações sobre essa tabela e como criá-la, veja Tabela de amostra HumanResources.myTeam (SQL Server).

R. Usar um arquivo de formato não XML

O arquivo de formato não XML seguinte usa o formato de dados nativo do SQL Server para a tabela HumanResources.myTeam. Esse arquivo de formato foi criado usando o comando bcp a seguir.

bcp AdventureWorks2022.HumanResources.myTeam format nul -f myTeam.Fmt -n -T

O comando bcp usa como padrão uma instância local padrão do SQL Server com a Autenticação do Windows. Você pode especificar outras informações de instância e logon conforme desejado, para mais informações, veja Utilitário bcp. Por exemplo, para especificar uma instância nomeada de servidor remoto com a Autenticação do Windows, use:

bcp AdventureWorks2022.HumanResources.myTeam format nul -f myTeam.Fmt -n -T -S servername/instancename

O conteúdo desse arquivo de formato é o seguinte, começando com o número de versão principal do SQL Server e as informações de metadados da tabela.

14.0
4
1       SQLSMALLINT   0       2       ""   1     EmployeeID               ""
2       SQLNCHAR      2       100     ""   2     Name                     SQL_Latin1_General_CP1_CI_AS
3       SQLNCHAR      2       100     ""   3     Title                    SQL_Latin1_General_CP1_CI_AS
4       SQLNCHAR      2       100     ""   4     Background               SQL_Latin1_General_CP1_CI_AS

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

B. Usar um arquivo de formato XML

O arquivo de formato XML seguinte usa o formato de dados nativo do SQL Server para a tabela HumanResources.myTeam. Esse arquivo de formato foi criado usando o comando bcp a seguir.

bcp AdventureWorks2022.HumanResources.myTeam format nul -f myTeam.xml -x -n -T

O arquivo de formato contém:

<?xml version="1.0"?>
<BCPFORMAT xmlns="http://schemas.microsoft.com/sqlserver/2004/bulkload/format" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<RECORD>
  <FIELD ID="1" xsi:type="NativePrefix" LENGTH="1"/>
  <FIELD ID="2" xsi:type="NCharPrefix" PREFIX_LENGTH="2" MAX_LENGTH="100" COLLATION="SQL_Latin1_General_CP1_CI_AS"/>
  <FIELD ID="3" xsi:type="NCharPrefix" PREFIX_LENGTH="2" MAX_LENGTH="100" COLLATION="SQL_Latin1_General_CP1_CI_AS"/>
  <FIELD ID="4" xsi:type="NCharPrefix" PREFIX_LENGTH="2" MAX_LENGTH="100" COLLATION="SQL_Latin1_General_CP1_CI_AS"/>
</RECORD>
<ROW>
  <COLUMN SOURCE="1" NAME="EmployeeID" xsi:type="SQLSMALLINT"/>
  <COLUMN SOURCE="2" NAME="Name" xsi:type="SQLNVARCHAR"/>
  <COLUMN SOURCE="3" NAME="Title" xsi:type="SQLNVARCHAR"/>
  <COLUMN SOURCE="4" NAME="Background" xsi:type="SQLNVARCHAR"/>
</ROW>
</BCPFORMAT>

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

Quando um arquivo de formato é necessário?

Os arquivos de formato geralmente são necessários nas seguintes circunstâncias:

  • Quando você usa uma instrução INSERT ... SELECT * FROM OPENROWSET(BULK...).

  • Para situações complexas de importação em massa usando bcp ou BULK INSERT.

  • O mesmo arquivo de dados for usado como origem para diversas tabelas que têm esquemas diferentes.

  • O arquivo de dados tiver um número diferente de campos do número de colunas da tabela de destino; por exemplo:

    • A tabela de destino contém pelo menos uma coluna para a qual há um valor padrão definido ou NULL é permitido.
    • Os usuários não têm permissões SELECT/INSERT em uma ou mais colunas na tabela.
    • Um único arquivo de dados é usado com duas ou mais tabelas que têm esquemas diferentes.
  • A ordem de colunas é diferente para o arquivo de dados e a tabela.

  • Os caracteres de terminação ou o comprimento dos prefixos diferem entre as colunas do arquivo de dados.

Observação

Na ausência de um arquivo de formato, se um comando bcp especificar um parâmetro de formato de dados (-n, -c, -w, ou -N) ou uma operação BULK INSERT especificar a opção DATAFILETYPE, o formato de dados especificado será usado como o método padrão de interpretação dos campos do arquivo de dados.