Método de nós() (Tipo de dados xml)

No exemplo a seguir, há um documento XML com um elemento de nível superior <Root> e três elementos filho <row>. A consulta usa o método nodes() para definir nós de contexto separados, um para cada elemento <row>. O método nodes() retorna um conjunto de linhas com três linhas. Cada linha tem uma cópia lógica do XML original, com cada nó de contexto identificando um elemento <row> diferente no documento original.

A consulta retorna o nó de contexto de cada linha:

DECLARE @x xml ;
SET @x='<Root>
    <row id="1"><name>Larry</name><oflw>some text</oflw></row>
    <row id="2"><name>moe</name></row>
    <row id="3" />
</Root>';
SELECT T.c.query('.') AS result
FROM   @x.nodes('/Root/row') T(c);
GO

O seguinte é o resultado. Neste exemplo, o método de consulta retorna o item de contexto e seu conteúdo:

 <row id="1"><name>Larry</name><oflw>some text</oflw></row>
 <row id="2"><name>moe</name></row>
 <row id="3"/>

Aplicando o acessador pai nos nós de contexto, o elemento <Root> é retornado para os três:

SELECT T.c.query('..') AS result
FROM   @x.nodes('/Root/row') T(c);
go

Este é o resultado:

<Root>
    <row id="1"><name>Larry</name><oflw>some text</oflw></row>
    <row id="2"><name>moe</name></row>
    <row id="3" />
</Root>
<Root>
    <row id="1"><name>Larry</name><oflw>some text</oflw></row>
    <row id="2"><name>moe</name></row>
    <row id="3" />
</Root>
<Root>
    <row id="1"><name>Larry</name><oflw>some text</oflw></row>
    <row id="2"><name>moe</name></row>
    <row id="3" />
</Root>

As instruções da bicicleta são usadas neste exemplo e armazenadas na coluna Instructions do tipo xml da tabela ProductModel. Para obter mais informações, consulte Representação de tipo de dados xml no banco de dados do AdventureWorks2008R2.

No exemplo a seguir, o método nodes() é especificado na coluna Instructions do tipo xml na tabela ProductModel.

O método nodes() define os elementos <Location> como nós de contexto especificando o caminho /MI:root/MI:Location. O conjunto de linhas resultante inclui cópias lógicas do documento original, uma para cada nó <Location> no documento, com o conjunto de nós de contexto definido como o elemento <Location>. Portanto, a função nodes() oferece um conjunto de nós de contexto <Location>.

O método query() nesse conjunto de linhas solicita self::node e, então, retorna o elemento <Location> em cada linha.

Nesse exemplo, a consulta define cada <Location> como um nó de contexto no documento de instruções de fabricação de um modelo de produto específico. É possível usar esses nós de contexto para recuperar valores conforme a seguir:

• Localizar IDs de Local em cada <Location>

• Recuperar etapas de fabricação (elementos filho <step>) em cada <Location>

Essa consulta retorna o item de contexto, no qual a sintaxe abreviada '.' para self::node() é especificada, no método query().

Observe o seguinte:

• O método nodes() é aplicado à coluna Instructions e retorna um conjunto de linhas, T (C). Esse conjunto de linhas contém cópias lógicas do documento de instruções de fabricação original com /root/Location como o item de contexto.

• CROSS APPLY aplica nodes() a cada linha da tabela Instructions e retorna somente as linhas que produzem um conjunto de resultados.

  SELECT C.query('.') as result
  FROM Production.ProductModel
  CROSS APPLY Instructions.nodes('
  declare namespace MI="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions";
  /MI:root/MI:Location') as T(C)
  WHERE ProductModelID=7
  

  Este é o resultado parcial:

  <MI:Location LocationID="10"  ...>
     <MI:step ... />
        ...
  </MI:Location>
  <MI:Location LocationID="20"  ... >
      <MI:step ... />
        ...
  </MI:Location>
  ...
  

O código a seguir faz uma consulta nos documentos XML sobre as ordens de fabricação na coluna Instructions da tabela ProductModel. A consulta retorna um conjunto de linhas contendo a ID de modelo de produto, locais de fabricação e etapas de fabricação.

Observe o seguinte:

• O método nodes() é aplicado à coluna Instructions e retorna o conjunto de linhas T1 (Locations). Esse conjunto de linhas contém cópias lógicas do documento de instruções de fabricação original, com o elemento /root/Location como o item de contexto.

• nodes() é aplicado ao conjunto de linhas T1 (Locations) e retorna o conjunto de linhas T2 (steps). Esse conjunto de linhas contém cópias lógicas do documento de instruções de fabricação original, com o elemento /root/Location/step como o item de contexto.

SELECT ProductModelID, Locations.value('./@LocationID','int') as LocID,
steps.query('.') as Step       
FROM Production.ProductModel       
CROSS APPLY Instructions.nodes('       
declare namespace MI="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions";       
/MI:root/MI:Location') as T1(Locations)       
CROSS APPLY T1.Locations.nodes('       
declare namespace MI="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions";       
./MI:step ') as T2(steps)       
WHERE ProductModelID=7       
GO       

Este é o resultado:

ProductModelID LocID Step       
----------------------------       
7      10   <step ... />       
7      10   <step ... />       
...       
7      20   <step ... />       
7      20   <step ... />       
7      20   <step ... />       
...       

A consulta declara o prefixo MI duas vezes. Em vez disso, você pode usar WITH XMLNAMESPACES para declarar o prefixo uma vez e usá-lo na consulta:

WITH XMLNAMESPACES (
   'https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions'  AS MI)

SELECT ProductModelID, Locations.value('./@LocationID','int') as LocID,
steps.query('.') as Step       
FROM Production.ProductModel       
CROSS APPLY Instructions.nodes('       
/MI:root/MI:Location') as T1(Locations)       
CROSS APPLY T1.Locations.nodes('       
./MI:step ') as T2(steps)       
WHERE ProductModelID=7       
GO