Sintaxe de esquema para arquivos de formato XML

Sintaxe básica de esquema XML

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

<BCPFORMAT...>

   <RECORD>

      <FIELD ID = "fieldID" xsi:type = "fieldType" [...]

      />

   </RECORD>

   <ROW>

      <COLUMN SOURCE = "fieldID" NAME = "columnName" xsi:type = "columnType" [...]

      />

   </ROW>

</BCPFORMAT>

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

Descrição dos elementos de esquema

Atributos do elemento <FIELD>

Atributos do elemento <COLUMN>

Esta seção descreve os atributos do elemento <COLUMN>, 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"/> mapeia 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 de quais atributos opcionais (abaixo) você necessita em uma determinada instância. Observação Os possíveis valores de ColumnType e seus atributos associados são listados na próxima tabela.	Opcional
LENGTH ="n"	Define o comprimento de uma instância de um tipo de dados de comprimento fixo. LENGTH só é usado quando xsi:type é um tipo de dados de cadeia de caracteres. O valor de n deve ser um inteiro positivo.	Opcional (disponível somente se xsi:type for 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 xsi:type for 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 xsi:type for um tipo de dados de número variável)
NULLABLE = { "YES" "NO" }	Indica se uma coluna pode assumir valores NULL. Esse atributo é completamente independente de FIELDS. Porém, se uma coluna não for NULLABLE e o campo especificar NULL (não especificando nenhum valor), ocorrerá erro em tempo de execução. O atributo NULLABLE será usado apenas se você executar uma instrução SELECT FROM OPENROWSET (BULK...) simples.	Opcional (disponível para qualquer tipo de dados)

Valores de Xsi:type do elemento <COLUMN>

O valor de xsi:type é uma construção XML (usada 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 xsi:type, consulte "Colocando o valor de xsi:type em um conjunto de dados", posteriormente nesta seção.

O elemento <COLUMN> oferece suporte a tipos de dados SQL nativos, do seguinte modo:

Categoria do tipo	Tipos de dados <COLUMN>	Atributos XML obrigató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 variável	SQLDECIMAL e SQLNUMERIC	Nenhum.	NULLABLE, PRECISION, SCALE
LOB	SQLIMAGE, CharLOB, SQLTEXT e SQLUDT	Nenhum.	NULLABLE
LOB caractere	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 importar ou exportar em massa dados SQLXML, use um dos seguinte tipos de dados em seu arquivo de formato: SQLCHAR ou SQLVARYCHAR (os dados são enviados na página de código cliente ou na página de código indicada pelo agrupamento), SQLNCHAR ou SQLNVARCHAR (os dados são enviados como Unicode) e SQLBINARY ou SQLVARYBIN (os dados são enviados sem qualquer conversão).

Para obter mais informações sobre os tipos de dados do SQL Server, consulte Tipos de dados (Transact-SQL).

Como a importação em massa usa o elemento &lt;ROW&gt;

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

• o comando bcp

  Quando dados são carregados em uma tabela de destino, o bcp ignora o componente <ROW>. Em vez disso, o bcp carrega os dados com base nos tipos de coluna da tabela de destino.

• Instruções Transact-SQL (BULK INSERT e o provedor de conjuntos de linhas em massa OPENROWSET)

  Ao importar dados em massa para uma tabela, as 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 em <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 de tipo pode conduzir a alguma discrepância (ou seja, uma perda de precisão) em comportamento no provedor de conjunto de linhas em massa do BULK INSERT ou OPENROWSET quando comparado ao bcp.

  As informações no elemento <ROW> permitem construir uma linha sem a necessidade de qualquer informação adicional. Por isso, você pode gerar um conjunto de linhas com a instrução SELECT (SELECT * FROM OPENROWSET(BULK datafile FORMATFILE=xmlformatfile).

  Observação
  A cláusula OPENROWSET BULK requer um arquivo de formato (observe que a conversão do tipo de dados de campo ao tipo de dados de uma coluna só é disponibilizada com um arquivo de formato XML).

Como a importação em massa usa o elemento &lt;COLUMN&gt;

Para importar dados em massa em uma tabela, os elementos <COLUMN> em um arquivo de formato mapeiam um campo de arquivo de dados para as colunas da 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 na(s) linha(s) gerada(s). Esse comportamento permite que um arquivo de dados gere linhas com colunas diferentes (em tabelas diferentes).

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

Colocando o valor de xsi:type em um conjunto de dados

Quando um documento XML é validado com a linguagem XSD (XML Schema Definition), o valor de xsi:type não é colocado no conjunto de dados. Porém, você pode colocar a informações de xsi:type no conjunto de dados carregando o arquivo de formato XML em um documento XML (por exemplo, myDoc), como ilustrado no fragmento de código seguinte:

...;
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");
}

Consulte também

Referência

Conceitos