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
, Title
e 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 tabela de destino contém pelo menos uma coluna para a qual há um valor padrão definido ou
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.
Tarefas relacionadas
- Uso de BCP nativo/arquivo de formato versus arquivo de texto e BOM
- Usar arquivos de formato não XML (SQL Server)
- Arquivos de formato XML (SQL Server)
- Formatos de dados para importar ou exportar em massa (SQL Server)
- Criar um arquivo de formato com bcp (SQL Server)
Conteúdo relacionado
- Utilitário bcp
- Usar um arquivo de formato para importação em massa de dados (SQL Server)
- Usar um arquivo de formato para ignorar uma coluna de tabela (SQL Server)
- Usar um arquivo de formato para ignorar um campo de dados (SQL Server)
- Usar um arquivo de formato para mapear colunas de tabela para campos de arquivo de dados (SQL Server)