nodes()-Methode (xml-Datentyp)

Im folgenden Beispiel liegt ein XML-Dokument vor, das über ein <Root>-Element auf oberster Ebene und drei untergeordnete <row>-Elemente verfügt. Die Abfrage verwendet die nodes()-Methode, um getrennte Kontextknoten festzulegen, einen für jedes <row>-Element. Die nodes()-Methode gibt ein Rowset mit drei Zeilen zurück. Jede Zeile enthält eine logische Kopie des ursprünglichen XML-Dokuments, wobei jeder Kontextknoten ein unterschiedliches <row>-Element im ursprünglichen Dokument identifiziert.

Die Abfrage gibt dann den Kontextknoten aus jeder Zeile zurück:

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

Im Folgenden wird das Ergebnis gezeigt. In diesem Beispiel gibt die Abfragemethode das Kontextelement und dessen Inhalt zurück:

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

Durch Anwenden des übergeordneten Accessors auf den Kontextknoten wird das <Root>-Element für alle drei zurückgegeben:

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

Dies ist das Ergebnis:

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

In diesem Beispiel werden die Produktionsanweisungen für Fahrräder verwendet und in der Instructions-Spalte vom Typ xml der ProductModel-Tabelle gespeichert. Weitere Informationen finden Sie unter Darstellung des xml-Datentyps in der AdventureWorks2008R2-Datenbank.

Im folgenden Beispiel wird die nodes()-Methode für die Instructions-Spalte vom Typ xml in der ProductModel-Tabelle angegeben.

Die nodes()-Methode legt die <Location>-Elemente als Kontextknoten fest, indem der /MI:root/MI:Location-Pfad angegeben wird. Das dadurch entstehende Rowset enthält logische Kopien des ursprünglichen Dokuments, eine für jeden <Location>-Knoten im Dokument, wobei der Kontextknoten auf das <Location>-Element festgelegt ist. Deshalb gibt die nodes()-Funktion eine Gruppe von <Location>-Kontextknoten zurück.

Die query()-Methode für dieses Rowset fordert self::node an und gibt deshalb das <Location>-Element in jeder Zeile zurück.

In diesem Beispiel legt die Abfrage jedes <Location>-Element als einen Kontextknoten im Produktionsanweisungsdokument eines bestimmten Produktmodells fest. Sie können diese Kontextknoten verwenden, um Werte wie z. B. die folgenden abzurufen:

• Suchen der Standort-IDs in jedem <Location>-Element

• Abrufen der Fertigungsschritte (untergeordnete <step>-Elemente) in jedem <Location>-Element

Diese Abfrage gibt in der query()-Methode das Kontextelement zurück, in dem die abgekürzte Syntax '.' für self::node() angegeben ist.

Beachten Sie Folgendes:

• Die nodes()-Methode wird auf die Instructions-Spalte angewendet und gibt das Rowset T (C) zurück. Dieses Rowset enthält logische Kopien des ursprünglichen Produktionsanweisungsdokuments mit /root/Location als Kontextelement.

• CROSS APPLY wendet nodes() auf jede Zeile in der Instructions-Tabelle an und gibt nur die Zeilen zurück, die ein Resultset erzeugen.

  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
  

  Dies ist das Teilergebnis:

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

Mit dem folgenden Code werden aus den XML-Dokumenten die Produktionsanweisungen in der Instructions-Spalte der ProductModel-Tabelle abgefragt. Die Abfrage gibt ein Rowset zurück, das die Produktmodell-ID, die Produktionsstandorte und die Fertigungsschritte enthält.

Beachten Sie Folgendes:

• Die nodes()-Methode wird auf die Instructions-Spalte angewendet und gibt das Rowset T1 (Locations) zurück. Dieses Rowset enthält logische Kopien des ursprünglichen Produktionsanweisungsdokuments mit dem /root/Location-Element als Elementkontext.

• nodes() wird auf das T1 (Locations)-Rowset angewendet und gibt das Rowset T2 (steps) zurück. Dieses Rowset enthält logische Kopien des ursprünglichen Produktionsanweisungsdokuments mit dem /root/Location/step-Element als Elementkontext.

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       

Dies ist das Ergebnis:

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

Die Abfrage deklariert das MI-Präfix zweimal. Sie können stattdessen WITH XMLNAMESPACES verwenden, um das Präfix einmal zu deklarieren und es dann in der Abfrage zu verwenden:

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