Compartilhar via

Exemplo: especificando a diretiva XMLTEXT

Este exemplo ilustra como os dados na coluna de transbordo são abordados usando a XMLTEXT diretiva em uma SELECT instrução usando o modo EXPLICIT.

Considere a Person tabela. 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 Person tabela. Para a Overflow coluna, 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!!XMLTEST] -- No AttributeName; XMLTEXT directive  
FROM Person  
FOR XML EXPLICIT;

No documento XML resultante:

  • Como AttributeName não é especificado para a coluna Overflow e a diretiva xmltext é especificada, os atributos no elemento <overflow> são acrescentados à lista de atributos do elemento que o contém <Parent>.

  • Como o atributo no elemento PersonID entra em conflito com o atributo PersonID recuperado no mesmo nível de elemento, o atributo no elemento <xmltext> é ignorado, mesmo que PersonID seja NULL. Geralmente, um atributo substitui um atributo do mesmo nome no transbordo.

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 subelementos do elemento envolvente <Parent>.

Por exemplo, altere os dados na Person tabela para que a Overflow coluna 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 <xmltext> elemento serão adicionados como subelementos do elemento delimitado:<Parent>

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 xmltext diretiva, os atributos do>overflow< elemento serão adicionados como atributos dos subelementos do elemento delimitado.<Parent> O nome especificado para AttributeName torna-se o nome do subelemento.

Nesta consulta, AttributeName, <overflow>é especificado junto com a xmltext diretiva:

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, é especificada a diretiva para o atributo PersonName. Isso resulta em PersonName ser adicionado como um subelemento do elemento delimitador <Parent>. Os atributos do <xmltext> ainda são acrescentados ao elemento delimitado.<Parent> O conteúdo do elemento <overflow>, que são subelementos, é pré-anexado aos outros subelementos dos elementos que os abrangem <Parent>.

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 XMLTEXT coluna 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 ASParent,  
       N'<overflow a="1"/>' AS 'overflow!1!!xmltext'  
FOR XML EXPLICIT, xmldata;

Este é o resultado. Observe que, no esquema retornado, o atributo a de estouro está ausente do esquema:

<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>

Consulte Também

Utilize o modo EXPLICIT com FOR XML

  • Last updated on