Exemplo: especificar a diretiva XMLTEXT
Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure
Este exemplo ilustra como dados na coluna de estouro são resolvidos usando a diretiva XMLTEXT em uma instrução SELECT
usando modo EXPLICIT.
Considere a tabela Person
. Esta tabela tem uma coluna Overflow
que armazena a parte não consumida do documento XML.
USE tempdb;
GO
CREATE TABLE Person(PersonID varchar(5), PersonName varchar(20), Overflow nvarchar(200));
GO
INSERT INTO Person VALUES
('P1','Joe',N'<SomeTag attr1="data">content</SomeTag>')
,('P2','Joe',N'<SomeTag attr2="data"/>')
,('P3','Joe',N'<SomeTag attr3="data" PersonID="P">content</SomeTag>');
Essa consulta recupera colunas da tabela Person
. Para a coluna Overflow
, AttributeName não é especificado, mas a diretiva é definida como XMLTEXT
como parte do fornecimento de um nome de coluna de tabela universal.
SELECT 1 as Tag, NULL as parent,
PersonID as [Parent!1!PersonID],
PersonName as [Parent!1!PersonName],
Overflow as [Parent!1!!XMLTEXT] -- No AttributeName; XMLTEXT directive
FROM Person
FOR XML EXPLICIT;
No documento XML resultante:
Como AttributeName não está especificado para a coluna
Overflow
e a diretivaxmltext
está especificada, os atributos no elemento<overflow>
são acrescentados à lista de atributos do elemento<Parent>
delimitador.Como o atributo
PersonID
no elemento<xmltext>
entra em conflito com o atributoPersonID
recuperado no mesmo nível de elemento, o atributo no elemento<xmltext>
é ignorado, mesmo quePersonID
seja NULL. Geralmente, um atributo substitui um atributo do mesmo nome no estouro.
Este é o resultado:
<Parent PersonID="P1" PersonName="Joe" attr1="data">content</Parent>
<Parent PersonID="P2" PersonName="Joe" attr2="data"></Parent>
<Parent PersonID="P3" PersonName="Joe" attr3="data">content</Parent>
Se os dados excedentes tiverem subelementos e a mesma consulta for especificada, os subelementos na coluna Overflow
serão adicionados como os subelementos do elemento <Parent>
delimitador.
Por exemplo, altere os dados na tabela Person
para que a coluna Overflow
agora tenha subelementos.
USE tempdb;
GO
TRUNCATE TABLE Person;
GO
INSERT INTO Person VALUES
('P1','Joe',N'<SomeTag attr1="data">content</SomeTag>')
,('P2','Joe',N'<SomeTag attr2="data"/>')
,('P3','Joe',N'<SomeTag attr3="data" PersonID="P"><name>PersonName</name></SomeTag>');
Se a mesma consulta for executada, os subelementos no elemento <xmltext>
serão adicionados como subelementos do elemento <Parent>
delimitador:
SELECT 1 as Tag, NULL as parent,
PersonID as [Parent!1!PersonID],
PersonName as [Parent!1!PersonName],
Overflow as [Parent!1!!XMLTEXT] -- no AttributeName, XMLTEXT directive
FROM Person
FOR XML EXPLICIT;
Este é o resultado:
<Parent PersonID="P1" PersonName="Joe" attr1="data">content</Parent>
<Parent PersonID="P2" PersonName="Joe" attr2="data"></Parent>
<Parent PersonID="P3" PersonName="Joe" attr3="data">
<name>PersonName</name>
</Parent>
Se AttributeName for especificado com a diretiva xmltext
, os atributos do elemento <overflow>
serão adicionados como atributos dos subelementos do elemento <Parent>
delimitador. O nome especificado para AttributeName se torna o nome do subelemento.
Nesta consulta, AttributeName, <overflow>
, é especificado junto com a diretiva xmltext
*:*
SELECT 1 as Tag, NULL as parent,
PersonID as [Parent!1!PersonID],
PersonName as [Parent!1!PersonName],
Overflow as [Parent!1!overflow!XMLTEXT] -- Overflow is AttributeName
-- XMLTEXT is a directive
FROM Person
FOR XML EXPLICIT;
Este é o resultado:
<Parent PersonID="P1" PersonName="Joe">
<overflow attr1="data">content</overflow>
</Parent>
<Parent PersonID="P2" PersonName="Joe">
<overflow attr2="data" />
</Parent>
<Parent PersonID="P3" PersonName="Joe">
<overflow attr3="data" PersonID="P">
<name>PersonName</name>
</overflow>
</Parent>
Neste elemento de consulta, directive está especificada para o atributo PersonName
. Isso resulta na adição de PersonName
como um subelemento do elemento <Parent>
delimitador. Os atributos de <xmltext>
ainda estão anexados ao elemento <Parent>
delimitador. O conteúdo do elemento <overflow>
e os subelementos são pré-acrescentados a outros subelementos dos elementos <Parent>
delimitadores.
SELECT 1 AS Tag, NULL as parent,
PersonID AS [Parent!1!PersonID],
PersonName AS [Parent!1!PersonName!element], -- element directive
Overflow AS [Parent!1!!XMLTEXT]
FROM Person
FOR XML EXPLICIT;
Este é o resultado:
<Parent PersonID="P1" attr1="data">content<PersonName>Joe</PersonName>
</Parent>
<Parent PersonID="P2" attr2="data">
<PersonName>Joe</PersonName>
</Parent>
<Parent PersonID="P3" attr3="data">
<name>PersonName</name>
<PersonName>Joe</PersonName>
</Parent>
Se os dados da coluna XMLTEXT
contiverem atributos no elemento raiz, esses atributos não serão mostrados no esquema de dados XML, e o analisador MSXML não validará o fragmento de documento XML resultante. Por exemplo:
SELECT 1 AS Tag,
0 AS Parent,
N'<overflow a="1"/>' AS 'overflow!1!!xmltext'
FOR XML EXPLICIT, xmldata;
Este é o resultado. No esquema retornado, o atributo excedente a
está ausente:
<Schema name="Schema2"
xmlns="urn:schemas-microsoft-com:xml-data"
xmlns:dt="urn:schemas-microsoft-com:datatypes">
<ElementType name="overflow" content="mixed" model="open">`
</ElementType>`
</Schema>`
<overflow xmlns="x-schema:#Schema2" a="1">
</overflow>