Arquivos de formato XML (SQL Server)

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

O SQL Server fornece um esquema XML que define a sintaxe para escrever arquivos de formato XML a serem usados para importar dados em massa para uma tabela do SQL Server. Arquivos no formato XML devem aderir a este esquema que está definido no Schema Definition Language XML (XSDL). 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.

Você pode usar um arquivo de formato XML com um comando bcp, BULK INSERT declaração ou INSERT ... SELECT * FROM OPENROWSET(BULK...) declaração. O comando bcp permite que você gere automaticamente um arquivo de formato XML para uma tabela; para obter mais informações, consulte o utilitário bcp.

Há suporte a dois tipos de arquivos de formato de exportação e importação em massa: arquivos de formato não XML e arquivos de formato XML. Arquivos de formato XML fornecem uma alternativa flexível e poderosa para arquivos de formato não XML. Para obter informações sobre arquivos de formato não XML, consulte Usar arquivos de formato não 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, realize 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 XML

Arquivos de formato XML são autodescritivos, o que facilita sua leitura, criação e extensão. Eles são legíveis por humanos, facilitando a compreensão de como os dados são interpretados durante operações em massa.

Arquivos no formato XML contêm os tipos de dados das colunas de destino. A codificação XML descreve claramente os tipos de dados e elementos de dados do arquivo de dados e também o mapeamento entre elementos de dados e colunas de tabela.

Isso permite a separação entre como os dados são representados no arquivo de dados e quais tipos de dados são associados a cada campo no arquivo. Por exemplo, se um arquivo de dados contiver uma representação de caracteres dos dados, o tipo de coluna SQL correspondente será perdido.

Um arquivo no formato XML permite carregar um campo contendo um único tipo de dado de objeto grande (LOB) de um arquivo de dados.

Um arquivo de formato XML pode ser aprimorado e ainda permanecer compatível com suas versões anteriores. Além disso, a clareza da codificação XML facilita a criação de arquivos em formatos múltiplos para um determinado arquivo de dados. Isto será útil se você tiver que mapear tudo ou alguns dos campos de dados para colunas em tabelas ou exibições diferentes.

A sintaxe de um arquivo de formato é independente da direção da operação; ou seja, a sintaxe é a mesma para exportação ou importação em massa.

Você pode usar arquivos no formato XML para importar em massa dados em tabelas ou visualizações não particionadas e para exportar em massa dados.

Para a função OPENROWSET(BULK...), especificar uma tabela de destino é opcional. Isso ocorre porque a função depende do arquivo de formato XML para ler dados de um arquivo de dados.

Observação

Uma tabela de destino é necessária com o comando bcp e a BULK INSERT instrução, que usa as colunas da tabela de destino para fazer a conversão de tipo.

Estrutura de arquivos de formato XML

Como um arquivo de formato não XML, um arquivo de formato XML define o formato e a estrutura dos campos de dados em um arquivo de dados e mapeia esses campos de dados a colunas em uma única tabela de destino.

Um arquivo de formato XML possui dois componentes <RECORD> principais e <ROW>:

<RECORD> descreve os dados como eles são armazenados no arquivo de dados.

Cada <RECORD> elemento contém um conjunto de um ou mais <FIELD> elementos. Estes elementos correspondem a campos no arquivo de dados. A sintaxe básica é a seguinte:
```
<RECORD>
    <FIELD .../> [ ...n ]
</RECORD>
```
Cada <FIELD> elemento descreve o conteúdo de um campo de dados específico. Um campo só pode ser mapeado para uma coluna na tabela. Nem todos os campos precisam ser mapeados para colunas.

Um campo em um arquivo de dados pode ser de comprimento fixo/variável ou terminado em caractere. Um valor de campo pode ser representado como: um caractere (usando representação de byte único), um caractere largo (usando representação unicode de 2 bytes), formato de banco de dados nativo ou um nome de arquivo. Se um valor de campo for representado como um nome de arquivo, o nome de arquivo apontará ao arquivo que contém o valor de uma coluna de BLOB na tabela destino.
<ROW> descreve como construir linhas de dados de um arquivo de dados quando os dados do arquivo são importados para uma tabela do SQL Server.

Um <ROW> elemento contém um conjunto de <COLUMN> elementos. Esses elementos correspondem a colunas de tabela. A sintaxe básica é a seguinte:
```
<ROW>
    <COLUMN .../> [ ...n ]
</ROW>
```
Cada <COLUMN> elemento pode ser mapeado para apenas um campo no arquivo de dados. A ordem dos <COLUMN> elementos no <ROW> elemento define a ordem na qual a operação em massa os retorna. O arquivo de formato XML atribui a cada elemento <COLUMN> um nome local que não tem nenhuma relação com a coluna na tabela de destino de uma operação de importação em massa.

Sintaxe de esquema para arquivos de formato XML

Esta seção contém um resumo dos elementos e atributos do esquema XML para arquivos no formato XML. A sintaxe de um arquivo de formato é independente da direção da operação; ou seja, a sintaxe é a mesma para exportação ou importação em massa. Esta seção também considera como a importação em massa usa os elementos <ROW> e <COLUMN>, além de como colocar o valor xsi:type de um elemento em um conjunto de dados.

Para ver como a sintaxe corresponde aos arquivos de formato XML atuais, confira Arquivos de formato XML de exemplo.

Observação

Você pode modificar um arquivo de formato para importar em massa de um arquivo de dados no qual o número e/ou a ordem dos campos difere do número e/ou da ordem das colunas na tabela. Para obter mais informações, confira Arquivos de formato para importar ou exportar dados (SQL Server).

Sintaxe básica de esquema XML

Essas instruções de sintaxe mostram apenas os elementos (<BCPFORMAT>, , <RECORD>, <FIELD>e <ROW>) e <COLUMN>seus atributos básicos.

Observação

Atributos adicionais associados ao valor de xsi:type em um elemento <FIELD> ou <COLUMN> são descritos posteriormente neste artigo.

Elementos de esquema

Esta seção resume a finalidade de cada elemento que o esquema XML define para os arquivos de formato XML. Os atributos são descritos em seções separadas posteriormente neste artigo.

<BCPFORMAT>

O elemento de formato de arquivo que define a estrutura do registro de um determinado arquivo de dados e sua correspondência às colunas de uma linha de tabela na tabela.
<RECORD .../>

Define um elemento complexo que contém um ou mais <FIELD> elementos. A ordem na qual os campos são declarados no arquivo de formato é a ordem na qual esses campos aparecem no arquivo de dados.
<FIELD .../>

Define um campo no arquivo de dados que contém dados. Os atributos desse elemento são discutidos em Atributos do <FIELD> Elemento, posteriormente neste artigo.
<ROW .../>

Define um elemento complexo que contém um ou mais <COLUMN> elementos. A ordem dos <COLUMN> elementos é independente da ordem dos <FIELD> elementos em uma RECORD definição. Em vez disso, a ordem dos <COLUMN> elementos em um arquivo de formato determina a ordem da coluna do conjunto de linhas resultante. Os campos de dados são carregados na ordem em que os elementos correspondentes <COLUMN> são declarados no <COLUMN> elemento. Para obter mais informações, consulte Como a importação em massa usa o <ROW> elemento, mais adiante neste artigo.
<COLUMN>

Define uma coluna como um elemento (<COLUMN>). Cada <COLUMN> elemento corresponde a um <FIELD> elemento (cuja ID é especificada no SOURCE atributo do <COLUMN> elemento). Os atributos desse elemento são discutidos em Atributos do <COLUMN> Elemento, posteriormente neste artigo. Veja também como a importação em massa usa o <COLUMN> elemento, mais adiante neste artigo.
</BCPFORMAT>

Obrigatório para finalizar o arquivo de formato.

Atributos do `<FIELD>` elemento

Esta seção descreve os atributos do <FIELD> elemento, que são resumidos na seguinte sintaxe de esquema:

<FIELD
ID ="fieldID"
xsi:type ="fieldType"
[ LENGTH ="n" ]
[ PREFIX_LENGTH ="p" ]
[ MAX_LENGTH ="m" ]
[ COLLATION ="collationName" ]
[ TERMINATOR ="terminator" ]
/>

Cada <FIELD> elemento é independente dos outros. Um campo é descrito em termos dos seguintes atributos:

Atributo FIELD	Descrição	Opcional / Obrigatório
*ID="fieldID"*	Especifica o nome lógico do campo no arquivo de dados. A ID de um campo é a chave para fazer referência ao campo. *<FIELD ID="fieldID" />* é mapeado para *<COLUMN SOURCE="fieldID" />*	Obrigatório
*xsi:type="fieldType"*	Essa é uma construção XML (usada como um atributo) que identifica o tipo da instância do elemento. O valor de fieldType determina quais dos atributos opcionais você precisa em uma determinada instância.	Obrigatório (dependendo do tipo de dados)
LENGTH="n"	Esse atributo define o comprimento de uma instância de um tipo de dados de comprimento fixo. O valor de n deve ser um inteiro positivo.	Opcional, a menos que seja exigido pelo `xsi:type` valor
PREFIX_LENGTH="p"	Esse atributo define o comprimento do prefixo para uma representação de dados binária. O `PREFIX_LENGTH`, p, deve ser um dos seguintes valores: `1`, , `2`, `4`ou `8`.	Opcional, a menos que seja exigido pelo `xsi:type` valor
MAX_LENGTH="m"	Esse atributo é o número máximo de bytes que pode ser armazenado em um determinado campo. Sem uma tabela de destino, o comprimento máximo da coluna não é conhecido. O `MAX_LENGTH` atributo restringe o comprimento máximo de uma coluna de caractere de saída, limitando o armazenamento alocado para o valor da coluna. Isso é especialmente conveniente ao usar a função `OPENROWSET` da opção `BULK` em uma cláusula `SELECT FROM`. O valor de m deve ser um inteiro positivo. Por padrão, o comprimento máximo é de 8.000 caracteres para uma coluna char e 4.000 caracteres para uma coluna nchar .	Opcional
*COLLATION="collationName"*	`COLLATION` só é permitido para campos de caracteres. Para obter uma lista dos nomes de ordenação do SQL Server, consulte Nome da Ordenação do SQL Server.	Opcional
*TERMINATOR="terminador"*	Esse atributo especifica o terminador de um campo de dados. O terminador pode ser qualquer caractere. O terminador deve ser um caractere exclusivo que não faça parte dos dados. Por padrão, o terminador de campo é o caractere de guia (representado como `\t`). Para representar uma marca de parágrafo, use `\r\n`.	Esse atributo é usado apenas com um `xsi:type` de dados de caracteres, que exige este atributo.

xsi:type valores do <FIELD> elemento

O xsi:type valor é um constructo XML (usado como um atributo) que identifica o tipo de dados de uma instância de um elemento. Para obter mais informações, consulte Colocar o valor xsi:type em uma seção do conjunto de dados neste artigo.

O xsi:type valor do <FIELD> elemento dá suporte aos seguintes tipos de dados.

`<FIELD>` `xsi:type` Valores	Atributos XML necessários para tipo de dados	Atributos XML opcionais para tipo de dados
`NativeFixed`	`LENGTH`	Nenhum.
`NativePrefix`	`PREFIX_LENGTH`	`MAX_LENGTH`
`CharFixed`	`LENGTH`	`COLLATION`
`NCharFixed`	`LENGTH`	`COLLATION`
`CharPrefix`	`PREFIX_LENGTH`	`MAX_LENGTH`, `COLLATION`
`NCharPrefix`	`PREFIX_LENGTH`	`MAX_LENGTH`, `COLLATION`
`CharTerm`	`TERMINATOR`	`MAX_LENGTH`, `COLLATION`
`NCharTerm`	`TERMINATOR`	`MAX_LENGTH`, `COLLATION`

Para obter mais informações sobre tipos de dados do SQL Server, consulte Tipos de dados.

Atributos do <COLUMN> elemento

Esta seção descreve os atributos do <COLUMN> elemento, que são resumidos na seguinte sintaxe de esquema:

<COLUMN
SOURCE = "fieldID"
NAME = "columnName"
xsi:type = "columnType"
[ LENGTH = "n" ]
[ PRECISION = "n" ]
[ SCALE = "value" ]
[ NULLABLE = { "YES" | "NO" } ]
/>

Um campo é mapeado para uma coluna na tabela de destino usando os seguintes atributos:

Atributo COLUMN	Descrição	Opcional / Obrigatório
*SOURCE="fieldID"*	Especifica a ID do campo que é mapeado para a coluna. *<COLUMN SOURCE=fieldID"/>* é mapeado para *<FIELD ID=fieldID"/>*	Obrigatório
*NAME="columnName"*	Especifica o nome da coluna no conjunto de linhas representado pelo arquivo de formato. Esse nome de coluna é usado para identificar a coluna no conjunto de resultados e não precisa corresponder ao nome da coluna usado na tabela de destino.	Obrigatório
*xsi:type="ColumnType"*	Essa é uma construção XML (usada como um atributo) que identifica o tipo de dados da instância do elemento. O valor de ColumnType determina quais dos atributos opcionais você precisa em uma determinada instância. Observação: Os valores possíveis de ColumnType e dos atributos associados estão listados na tabela do elemento `<COLUMN>` nos valores xsi:type da seção <COLUMN> elemento.	Opcional
LENGTH="n"	Define o comprimento de uma instância de um tipo de dados de comprimento fixo. `LENGTH` é usado somente quando `xsi:type` é do tipo de dados string. O valor de n deve ser um inteiro positivo.	Opcional (disponível somente se for `xsi:type` um tipo de dados de cadeia de caracteres)
PRECISION="n"	Indica o número de dígitos em um número. Por exemplo, o número 123,45 tem uma precisão de 5. O valor deve ser um inteiro positivo.	Opcional (disponível somente se for `xsi:type` um tipo de dados de número variável)
*SCALE="int"*	Indica o número de dígitos à direita da casa decimal em um número. Por exemplo, o número 123,45 tem uma escala de 2. O valor deve ser um inteiro.	Opcional (disponível somente se for `xsi:type` um tipo de dados de número variável)
NULLABLE={ "SIM" \| "NÃO" }	Indica se uma coluna pode assumir `NULL` valores. Esse atributo é independente de `FIELDS`. Porém, se uma coluna não permitir valores nulos e o campo for definido como `NULL` (não especificando nenhum valor), ocorrerá um erro em tempo de execução. O atributo `NULLABLE` é usado somente se você fizer uma declaração simples `SELECT FROM OPENROWSET(BULK...)`.	Opcional (disponível para qualquer tipo de dados)

xsi:type valores do <COLUMN> elemento

O xsi:type valor é um constructo XML (usado como um atributo) que identifica o tipo de dados de uma instância de um elemento. Para obter informações sobre como usar o valor de "Colocando o valor de xsi:type em um conjunto de dados" posteriormente nesta seção.

O <COLUMN> elemento dá suporte a tipos de dados SQL nativos, da seguinte maneira:

Categoria de tipo	`<COLUMN>` tipos de dados	Atributos XML necessários para tipo de dados	Atributos XML opcionais para tipo de dados
Fixo	`SQLBIT`, `SQLTINYINT`, `SQLSMALLINT`, `SQLINT`, `SQLBIGINT`, `SQLFLT4`, `SQLFLT8`, `SQLDATETIME`, `SQLDATETIM4`, `SQLDATETIM8`, `SQLMONEY`, `SQLMONEY4`, `SQLVARIANT`, e `SQLUNIQUEID`	Nenhum.	`NULLABLE`
Número de variável	`SQLDECIMAL` e `SQLNUMERIC`	Nenhum.	`NULLABLE`, `PRECISION`, `SCALE`
Data e hora variáveis	`SQLDATETIME2`, `SQLTIME`, `SQLDATETIMEOFFSET`	Nenhum.	`NULLABLE`, `SCALE`
LOB	`SQLIMAGE`, `CharLOB`, `SQLTEXT`e `SQLUDT`	Nenhum.	`NULLABLE`
LOB de caracteres	`SQLNTEXT`	Nenhum.	`NULLABLE`
Cadeia de caracteres binária	`SQLBINARY` e `SQLVARYBIN`	Nenhum.	`NULLABLE`, `LENGTH`
Cadeia de caracteres	`SQLCHAR`, `SQLVARYCHAR`, `SQLNCHAR`e `SQLNVARCHAR`	Nenhum.	`NULLABLE`, `LENGTH`

Importante

Para exportar ou importar dados SQLXML em massa, use um dos seguintes tipos de dados em seu arquivo de formato: SQLCHAR ou SQLVARYCHAR (os dados são enviados na página de código do cliente ou na página de código implícita pela ordenação) SQLNCHAR ou SQLNVARCHAR (os dados são enviados como Unicode) ou SQLBINARY ou SQLVARYBIN (os dados são enviados sem nenhuma conversão).

Para obter mais informações sobre tipos de dados do SQL Server, consulte Tipos de dados.

Como a importação em massa usa o `<ROW>` elemento

O <ROW> elemento é ignorado em alguns contextos. Se o <ROW> elemento afeta uma operação de importação em massa depende de como a operação é executada:

O comando bcp

Quando os dados são carregados em uma tabela de destino, bcp ignora o <ROW> componente. Em vez disso, o bcp carrega os dados com base nos tipos de coluna da tabela de destino.
Instruções Transact-SQL (provedor de conjunto de linhas em massa do BULK INSERT e OPENROWSET)

Ao importar dados em massa para uma tabela, instruções Transact-SQL usam o componente <ROW> para gerar o conjunto de linhas de entrada. Além disso, as instruções Transact-SQL executam conversões de tipo apropriadas, com base nos tipos de coluna especificados sob <ROW> e na coluna correspondente na tabela de destino. Se houver uma incompatibilidade entre os tipos de coluna como especificado no arquivo de formato e na tabela de destino, ocorrerá uma conversão extra de tipo. Essa conversão extra do tipo pode levar a alguma discrepância (ou seja, uma perda de precisão) de comportamento no provedor do conjunto de linhas em massa do BULK INSERT ou do OPENROWSET quando comparado com o bcp.

As informações no <ROW> elemento permitem que uma linha seja construída sem a necessidade de informações adicionais. Por esse motivo, você pode gerar um conjunto de linhas usando uma SELECT instrução (SELECT * FROM OPENROWSET(BULK <data-file> FORMATFILE=<xml-format-file>).

A OPENROWSET BULK cláusula requer um arquivo de formato. A conversão do tipo de dados do campo para o tipo de dados de uma coluna só está disponível com um arquivo de formato XML.

Como a importação em massa usa o `<COLUMN>` elemento

Para importar dados em massa para uma tabela, os <COLUMN> elementos em um arquivo de formato mapeiam um campo de arquivo de dados para colunas de tabela especificando:

A posição de cada campo dentro de uma linha no arquivo de dados.
O tipo de coluna usado para converter o tipo de dados de campo ao tipo de dados de coluna desejado.

Se nenhuma coluna for mapeada para um campo, o campo não será copiado para as linhas geradas. Esse comportamento permite que um arquivo de dados gere linhas com colunas diferentes (em tabelas diferentes).

Da mesma forma, para exportar em massa dados de uma tabela, cada <COLUMN> no arquivo de formato mapeia a coluna da linha de entrada da tabela para seu campo correspondente no arquivo de dados de saída.

Colocar o `xsi:type` valor em um conjunto de dados

Quando um documento XML é validado por meio da linguagem XSD (Definição de Esquema XML), o xsi:type valor não é colocado no conjunto de dados. No entanto, você pode colocar as xsi:type informações no conjunto de dados carregando o arquivo de formato XML em um documento XML (por exemplo, myDoc), conforme ilustrado no seguinte snippet de código:

...;
myDoc.LoadXml(xmlFormat);
XmlNodeList ColumnList = myDoc.GetElementsByTagName("COLUMN");
for (int i = 0; i < ColumnList.Count; i++)
{
    Console.Write($"COLUMN: xsi:type={ColumnList[i].Attributes["type",
        "http://www.w3.org/2001/XMLSchema-instance"].Value}\n");
}

Arquivos de formato XML de exemplo

Esta seção contém informações sobre como usar arquivos de formato XML em vários casos, incluindo um exemplo do Adventure Works.

Observação

Nos arquivos de dados mostrados nos exemplos a seguir, <tab> indica um caractere de tabulação em um arquivo de dados e <return> indica um retorno de carro.

Os exemplos ilustram aspectos fundamentais de como usar arquivos de formato XML, desta forma:

Ordenar campos de dados de caracteres da mesma forma que colunas de tabela
Ordenar campos de dados e colunas de tabela de forma diferente
Omitir um campo de dados
Mapear diferentes tipos de campos para colunas
Mapear dados XML para uma tabela
Importar campos de comprimento fixo ou largura fixa
Exemplos adicionais

Para obter informações sobre como criar arquivos de formato, consulte Criar um arquivo de formato com bcp (SQL Server).

A. Ordenar campos de dados de caracteres da mesma forma que colunas de tabelas

O exemplo a seguir mostra um arquivo de formato XML que descreve um arquivo de dados com três campos de dados de caracteres. O arquivo de formato mapeia o arquivo de dados para uma tabela que contém três colunas. Os campos de dados correspondem um a um às colunas da tabela.

Tabela (linha):Person (Age INT, FirstName VARCHAR(20), LastName VARCHAR(30))
Arquivo de dados (registro):Age<tab>FirstName<tab>LastName<return>

O arquivo de formato XML a seguir grava do arquivo de dados na tabela.

No elemento <RECORD> , o arquivo de formato representa os valores de dados em todos os três campos como dados de caracteres. Para cada campo, o atributo TERMINATOR indica o terminador que segue o valor dos dados.

Os campos de dados correspondem um a um às colunas da tabela. No elemento <ROW> , o arquivo de formato mapeia a coluna Age para o primeiro campo, a coluna FirstName para o segundo campo e a coluna LastName para o terceiro campo.

<?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="CharTerm" TERMINATOR="\t"
            MAX_LENGTH="12" />
        <FIELD ID="2" xsi:type="CharTerm" TERMINATOR="\t"
            MAX_LENGTH="20" COLLATION="SQL_Latin1_General_CP1_CI_AS" />
        <FIELD ID="3" xsi:type="CharTerm" TERMINATOR="\r\n"
            MAX_LENGTH="30"
            COLLATION="SQL_Latin1_General_CP1_CI_AS" />
    </RECORD>
    <ROW>
        <COLUMN SOURCE="1" NAME="age" xsi:type="SQLINT" />
        <COLUMN SOURCE="2" NAME="firstname" xsi:type="SQLVARYCHAR" />
        <COLUMN SOURCE="3" NAME="lastname" xsi:type="SQLVARYCHAR" />
    </ROW>
</BCPFORMAT>

Observação

Para obter um exemplo equivalente AdventureWorks2025 , consulte Criar um arquivo de formato com bcp (SQL Server).

B. Ordenar campos de dados e colunas de tabela diferentemente

O exemplo a seguir mostra um arquivo de formato XML que descreve um arquivo de dados com três campos de dados de caracteres. O arquivo de formato mapeia o arquivo de dados para uma tabela que contém três colunas ordenadas diferentemente dos campos do arquivo de dados.

Tabela (linha):Person (Age INT, FirstName VARCHAR(20), LastName VARCHAR(30))
Arquivo de dados (registro):Age<tab>FirstName<tab>LastName<return>

No elemento <RECORD> , o arquivo de formato representa os valores de dados em todos os três campos como dados de caracteres.

No elemento <ROW> , o arquivo de formato mapeia a coluna Age para o primeiro campo, a coluna FirstName para o terceiro campo e a coluna LastName para o segundo campo.

<?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="CharTerm" TERMINATOR="\t"
            MAX_LENGTH="12" />
        <FIELD ID="2" xsi:type="CharTerm" TERMINATOR="\t" MAX_LENGTH="20"
            COLLATION="SQL_Latin1_General_CP1_CI_AS" />
        <FIELD ID="3" xsi:type="CharTerm" TERMINATOR="\r\n"
            MAX_LENGTH="30" COLLATION="SQL_Latin1_General_CP1_CI_AS" />
    </RECORD>
    <ROW>
        <COLUMN SOURCE="1" NAME="age" xsi:type="SQLINT" />
        <COLUMN SOURCE="3" NAME="firstname" xsi:type="SQLVARYCHAR" />
        <COLUMN SOURCE="2" NAME="lastname" xsi:type="SQLVARYCHAR" />
    </ROW>
</BCPFORMAT>

Observação

Para obter um exemplo equivalente AdventureWorks2025 , consulte Usar um arquivo de formato para mapear colunas de tabela para campos de arquivo de dados (SQL Server).

C. Adicionar um campo de dados

O exemplo a seguir mostra um arquivo de formato XML que descreve um arquivo de dados com quatro campos de dados de caracteres. O arquivo de formato mapeia o arquivo de dados para uma tabela que contém três colunas. O segundo campo de dados não corresponde a nenhuma coluna de tabela.

Tabela (linha):Person (Age INT, FirstName VARCHAR(20), LastName VARCHAR(30))
Arquivo de dados (registro):Age<tab>FirstName<tab>LastName<return>

No elemento <RECORD> , o arquivo de formato representa os valores de dados em todos os quatro campos como dados de caractere. Para cada campo, o atributo TERMINATOR indica o terminador que segue o valor dos dados.

No elemento <ROW> , o arquivo de formato mapeia a coluna Age para o primeiro campo, a coluna FirstName para o terceiro campo e a coluna LastName para o quarto campo.

<?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="CharTerm" TERMINATOR="\t"
            MAX_LENGTH="12" />
        <FIELD ID="2" xsi:type="CharTerm" TERMINATOR="\t"
            MAX_LENGTH="10"
            COLLATION="SQL_Latin1_General_CP1_CI_AS" />
        <FIELD ID="3" xsi:type="CharTerm" TERMINATOR="\t"
            MAX_LENGTH="20"
            COLLATION="SQL_Latin1_General_CP1_CI_AS" />
        <FIELD ID="4" xsi:type="CharTerm" TERMINATOR="\r\n"
            MAX_LENGTH="30"
            COLLATION="SQL_Latin1_General_CP1_CI_AS" />
    </RECORD>
    <ROW>
        <COLUMN SOURCE="1" NAME="age" xsi:type="SQLINT" />
        <COLUMN SOURCE="3" NAME="firstname" xsi:type="SQLVARYCHAR" />
        <COLUMN SOURCE="4" NAME="lastname" xsi:type="SQLVARYCHAR" />
    </ROW>
</BCPFORMAT>

Observação

Para obter um exemplo equivalente AdventureWorks2025 , consulte Usar um arquivo de formato para ignorar um campo de dados (SQL Server).

D. Mapear `<FIELD>` xsi:type para `<COLUMN>` xsi:type

O exemplo a seguir mostra tipos diferentes de campos e seu mapeamento para colunas.

<?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 xsi:type="CharTerm" ID="C1" TERMINATOR="\t"
            MAX_LENGTH="4" />
        <FIELD xsi:type="CharFixed" ID="C2" LENGTH="10"
            COLLATION="SQL_LATIN1_GENERAL_CP1_CI_AS" />
        <FIELD xsi:type="CharPrefix" ID="C3" PREFIX_LENGTH="2"
            MAX_LENGTH="32" COLLATION="SQL_LATIN1_GENERAL_CP1_CI_AS" />
        <FIELD xsi:type="NCharTerm" ID="C4" TERMINATOR="\t"
            MAX_LENGTH="4" />
        <FIELD xsi:type="NCharFixed" ID="C5" LENGTH="10"
            COLLATION="SQL_LATIN1_GENERAL_CP1_CI_AS" />
        <FIELD xsi:type="NCharPrefix" ID="C6" PREFIX_LENGTH="2"
            MAX_LENGTH="32" COLLATION="SQL_LATIN1_GENERAL_CP1_CI_AS" />
        <FIELD xsi:type="NativeFixed" ID="C7" LENGTH="4" />
    </RECORD>
    <ROW>
        <COLUMN SOURCE="C1" NAME="Age" xsi:type="SQLTINYINT" />
        <COLUMN SOURCE="C2" NAME="FirstName" xsi:type="SQLVARYCHAR"
            LENGTH="16" NULLABLE="NO" />
        <COLUMN SOURCE="C3" NAME="LastName" />
        <COLUMN SOURCE="C4" NAME="Salary" xsi:type="SQLMONEY" />
        <COLUMN SOURCE="C5" NAME="Picture" xsi:type="SQLIMAGE" />
        <COLUMN SOURCE="C6" NAME="Bio" xsi:type="SQLTEXT" />
        <COLUMN SOURCE="C7" NAME="Interest" xsi:type="SQLDECIMAL"
            PRECISION="5" SCALE="3" />
    </ROW>
</BCPFORMAT>

E. Mapear dados XML para uma tabela

O exemplo a seguir cria uma tabela de duas colunas vazias (t_xml), na qual a primeira coluna mapeia para o tipo de dados int e a segunda coluna mapeia para o tipo de dados xml .

CREATE TABLE t_xml (c1 INT, c2 XML);

O arquivo de formato XML a seguir carrega um arquivo de dados na tabela t_xml.

<?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" PREFIX_LENGTH="1" />
        <FIELD ID="2" xsi:type="NCharPrefix" PREFIX_LENGTH="8" />
    </RECORD>
    <ROW>
        <COLUMN SOURCE="1" NAME="c1" xsi:type="SQLINT" />
        <COLUMN SOURCE="2" NAME="c2" xsi:type="SQLNCHAR" />
    </ROW>
</BCPFORMAT>

F. Importar campos de comprimento fixo ou de largura fixa

O exemplo a seguir descreve campos fixos de 10 ou de 6 caracteres cada. O arquivo de formato representa o comprimento/largura desses campos como LENGTH="10" e LENGTH="6", respectivamente. Cada linha dos arquivos de dados termina com uma combinação de alimentação de linha de retorno de carro <CR><LF>, que o arquivo de formato representa como TERMINATOR="\r\n".

<?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="CharFixed" LENGTH="10" />
        <FIELD ID="2" xsi:type="CharFixed" LENGTH="6" />
        <FIELD ID="3" xsi:type="CharTerm" TERMINATOR="\r\n" />
    </RECORD>
    <ROW>
        <COLUMN SOURCE="1" NAME="C1" xsi:type="SQLINT" />
        <COLUMN SOURCE="2" NAME="C2" xsi:type="SQLINT" />
    </ROW>
</BCPFORMAT>

Mais exemplos

Para obter mais exemplos de arquivos de formato não XML e arquivos de formato XML, consulte os seguintes artigos:

Comentários

Esta página foi útil?

Last updated on 2025-07-19

Compartilhar via

Arquivos de formato XML (SQL Server)

Benefícios de arquivos de formato XML

Estrutura de arquivos de formato XML

Sintaxe de esquema para arquivos de formato XML

Sintaxe básica de esquema XML

Elementos de esquema

Atributos do <FIELD> elemento

Como a importação em massa usa o <ROW> elemento

Como a importação em massa usa o <COLUMN> elemento

Colocar o xsi:type valor em um conjunto de dados

Arquivos de formato XML de exemplo

A. Ordenar campos de dados de caracteres da mesma forma que colunas de tabelas

B. Ordenar campos de dados e colunas de tabela diferentemente

C. Adicionar um campo de dados

D. Mapear <FIELD> xsi:type para <COLUMN> xsi:type

E. Mapear dados XML para uma tabela

F. Importar campos de comprimento fixo ou de largura fixa

Mais exemplos

Tarefas relacionadas

Conteúdo relacionado

Comentários

Recursos adicionais

Atributos do `<FIELD>` elemento

Como a importação em massa usa o `<ROW>` elemento

Como a importação em massa usa o `<COLUMN>` elemento

Colocar o `xsi:type` valor em um conjunto de dados

D. Mapear `<FIELD>` xsi:type para `<COLUMN>` xsi:type