Gerando instâncias XML

Instâncias de cadeia de caracteres de conversão de tipos e binárias

É possível analisar qualquer um dos tipos de dados de cadeia de caracteres do SQL Server, como [n][var]char, [n]text, varbinary e image, dentro do tipo de dados xml convertendo (CAST) ou (CONVERT) a cadeia de caracteres em tipo de dados xml. XML sem tipo é verificado para confirmar se está bem formado. Se houver um esquema associado ao tipo xml, validação também será executada. Para obter mais informações, consulte XML digitado comparado com XML não digitado.

Documentos de XML podem ser codificados com diferentes codificações (por exemplo, UTF-8, UTF-16, Windows-1252). O seguinte descreve as regras de como os tipos de origem de cadeia de caracteres e binários interagem com a codificação do documento XML e como o analisador se comporta.

Como nvarchar pressupõe uma codificação Unicode de dois bytes, como UTF-16 ou UCS-2, o analisador XML tratará o valor da cadeia de caracteres como um documento ou fragmento XML codificado em Unicode de dois bytes. Isso indica que o documento XML precisa ser codificado em uma codificação Unicode bem como ser compatível com o tipo de dados da origem Um documento XML codificado em UTF-16 pode ter uma BOM (marca de ordem de byte), mas isso não é necessário, pois o contexto do tipo de origem torna claro que ele pode ser apenas um documento codificado em Unicode de dois bytes.

O conteúdo de uma cadeia de caracteres varchar é tratado como um documento/fragmento XML codificado em um byte pelo analisador XML. Como a cadeia de caracteres de origem varchar tem uma página de código associada, o analisador usará essa página de código para a codificação, se nenhuma codificação explícita for especificada no próprio XML. Se uma instância XML tiver uma BOM ou uma declaração de codificação, a BOM ou declaração precisará ser consistente com a página de código, caso contrário o analisador relatará um erro.

O conteúdo de varbinary é tratado como um fluxo de codepoint que é passado diretamente ao analisador XML. Assim, o documento ou fragmento XML precisa fornecer a BOM ou outras informações embutidas de codificação. O analisador examinará o fluxo apenas para determinar a codificação. Isso significa que XML codificado em UTF-16 precisa fornecer a BOM de UTF-16 e que uma instância sem BOM e sem uma codificação de declaração será interpretada como UTF-8.

Se a codificação do documento XML não for conhecida antecipadamente e os dados forem passados como cadeias de caracteres ou binários em vez de dados XML antes da conversão em XML, será recomendável tratar os dados como varbinary. Por exemplo, ao ler dados de um arquivo XML usando OpenRowset(), deve-se especificar os dados a serem lidos como um valor varbinary(max):

select CAST(x as XML) 
from OpenRowset(BULK 'filename.xml', SINGLE_BLOB) R(x)

O SQL Server representa XML internamente em uma representação binária eficiente que usa codificação UTF-16. A codificação fornecida pelo usuário não é preservada, mas é considerada durante o processo de análise.

Tipos de dado CLR definidos pelo usuário para conversão de tipo

Tratamento de espaço em branco em XML com tipo

declare @x xml
set @x = '<root>      <child/>     </root>'
select @x 

<root><child/></root>

SELECT CONVERT(xml, N'<root>      <child/>     </root>', 1)

Exemplo: Converter um valor de cadeia de caracteres em xml com tipo e atribuí-lo a uma coluna

CREATE TABLE T(c1 int primary key, c2 xml)
go
DECLARE  @s varchar(100)
SET @s = '<Cust><Fname>Andrew</Fname><Lname>Fuller</Lname></Cust>' 

INSERT INTO T VALUES (3, @s) 

INSERT INTO T VALUES (3, cast (@s as xml))

INSERT INTO T VALUES (3, convert (xml, @s)) 

Exemplo: Converter uma cadeia de caracteres em xml com tipo e atribuí-la a uma variável

declare @x xml
declare  @s varchar(100)
SET @s = '<Cust><Fname>Andrew</Fname><Lname>Fuller</Lname></Cust>' 
set @x =convert (xml, @s)
select @x

Usando a instrução SELECT com a cláusula FOR XML

É possível usar a cláusula FOR XML em uma instrução SELECT para retornar resultados como XML. Por exemplo:

DECLARE @xmlDoc xml
SET @xmlDoc = (SELECT Column1, Column2
               FROM   Table1, Table2
               WHERE   Some condition
               FOR XML AUTO)
 ...

A instrução SELECT retorna um fragmento XML textual que, em seguida, é analisado durante a atribuição à variável de tipo de dados xml.

Também é possível usar a diretiva TYPE na cláusula FOR XML que retorna um resultado da consulta FOR XML diretamente como tipo xml:

Declare @xmlDoc xml
SET @xmlDoc = (SELECT ProductModelID, Name
               FROM   Production.ProductModel
               WHERE  ProductModelID=19
               FOR XML AUTO, TYPE)
SELECT @xmlDoc

Este é o resultado:

<Production.ProductModel ProductModelID="19" Name="Mountain-100" />...

No exemplo a seguir, o resultado xml com tipo de uma consulta FOR XML é inserido em uma coluna de tipo xml:

CREATE TABLE T1 (c1 int, c2 xml)
go
INSERT T1(c1, c2)
SELECT 1, (SELECT ProductModelID, Name
           FROM Production.ProductModel
           WHERE ProductModelID=19
           FOR XML AUTO, TYPE)
SELECT * FROM T1
go

Para obter mais informações sobre FOR XML, consulte Construindo XML usando FOR XML.

Observação

O SQL Server retorna instâncias de tipo de dados xmlao cliente como um resultado das diferentes construções do servidor como consultas FOR XML que usam a diretiva TYPE ou onde o tipo de dados xml é usado para retornar XML de colunas, variáveis e parâmetros de saída SQL. No código do aplicativo cliente, o provedor ADO.NET solicita que essas informações de tipo de dados xml sejam enviadas em uma codificação binária do servidor. Porém, se você estiver usando FOR XML sem a diretiva TYPE, os dados XML retornarão como um tipo de cadeia de caracteres. De qualquer forma, o provedor cliente sempre poderá controlar qualquer formulário de XML.

Usando atribuições de constantes

Uma constante de cadeia de caracteres pode ser usada onde uma instância do tipo de dados xml é esperada. Isso é o mesmo que uma CAST implícita de cadeia de caracteres em XML. Por exemplo:

DECLARE @xmlDoc xml
SET @xmlDoc = '<Cust><Fname>Andrew</Fname><Lname>Fuller</Lname></Cust>' 
-- Or
SET @xmlDoc = N'<?xml version="1.0" encoding="ucs-2"?><doc/>'

O exemplo anterior converte implicitamente a cadeia de caracteres no tipo de dados xml e a atribui a uma variável de tipo xml.

O exemplo a seguir insere uma cadeia de caracteres constante em uma coluna de tipo xml:

CREATE TABLE T(c1 int primary key, c2 xml)
INSERT INTO T VALUES (3, '<Cust><Fname>Andrew</Fname><Lname>Fuller</Lname></Cust>') 

Observação
Para XML com tipo, o XML é validado em relação ao esquema especificado. Para obter mais informações, consulte XML digitado comparado com XML não digitado.

Usando carregamento em massa

A funcionalidade OPENROWSET (Transact-SQL) aprimorada permite carregar documentos XML em massa no banco de dados. É possível carregar instâncias XML em massa de arquivos em colunas de tipo xml no banco de dados. Para obter exemplos de funcionamento, consulte Exemplos de importação e exportação em massa de documentos XML. Para obter mais informações sobre carregamento de documentos XML, consulte Carregando dados XML.

Nesta seção

Consulte também

Conceitos

Outros recursos