nodes() メソッド (xml データ型)

次の例では、<Root> 最上位要素と 3 つの <row> 子要素が含まれる XML ドキュメントを使用します。このクエリでは、nodes() メソッドを使用して、各 <row> 要素に 1 つずつ別のコンテキスト ノードを設定します。nodes() メソッドにより、3 つの行を持つ行セットが返されます。各行には元の XML の論理コピーが含まれ、それぞれのコンテキスト ノードで元のドキュメントの異なる <row> 要素が識別されます。

その後、次のクエリを実行すると、各行のコンテキスト ノードが返されます。

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

次に結果を示します。この例では、クエリのメソッドでコンテキスト アイテムとそのコンテンツが返されます。

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

次のように、親アクセサーをコンテキスト ノードに適用すると、3 つのノードすべての <Root> 要素が返されます。

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

次に結果を示します。

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

この例では、ProductModel テーブルの xml 型の Instructions 列に格納されている、自転車の製造手順を使用します。詳細については、「AdventureWorks2008R2 データベースの xml データ型表現」を参照してください。

次の例では、ProductModel テーブルの xml 型の Instructions 列に対して nodes() メソッドを指定します。

/MI:root/MI:Location パスを指定することで、nodes() メソッドでは <Location> 要素がコンテキスト ノードに設定されます。結果の行セットには、ドキュメントの各 <Location> ノードに 1 つずつ元のドキュメントの論理コピーが含まれます。また、その <Location> 要素がコンテキスト ノードに設定されます。したがって、nodes() 関数から返されるのは、<Location> コンテキスト ノードのセットです。

この行セットに対する query() メソッドでは self::node が要求されるため、各行の <Location> 要素が返されます。

この例のクエリでは、各 <Location> 要素が、特定の製品モデルの製造手順ドキュメントのコンテキスト ノードとして設定されます。これらのコンテキスト ノードを使用して、次のような値を取得できます。

• 各 <Location> の場所 ID

• 各 <Location> の製造手順 (<step> 子要素)

このクエリでは、query() メソッドで self::node() に対する省略構文 '.' を指定して、コンテキスト アイテムを返しています。

次の点に注意してください。

• nodes() メソッドは Instructions 列に適用され、行セット T (C) を返します。この行セットには、/root/Location をコンテキスト アイテムとして、元の製造手順ドキュメントの論理コピーが格納されています。

• CROSS APPLY により、Instructions テーブルの各行に nodes() が適用され、結果セットを生成する行のみが返されます。

  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
  

  結果の一部を次に示します。

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

次のコードでは、XML ドキュメントに対し、ProductModel テーブルの Instructions 列に格納されている製造手順を照会しています。このクエリでは、製品モデル ID、製造場所、および製造手順が含まれた行セットが返されます。

次の点に注意してください。

• nodes() メソッドは Instructions 列に適用され、T1 (Locations) 行セットを返します。この行セットには、/root/Location をコンテキスト アイテムとして、元の製造手順ドキュメントの論理コピーが格納されています。

• nodes() は T1 (Locations) 行セットに適用され、T2 (steps) 行セットを返します。この行セットには、/root/Location/step をコンテキスト アイテムとして、元の製造手順ドキュメントの論理コピーが格納されています。

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       

次に結果を示します。

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

このクエリでは、MI プレフィックスを 2 回宣言しています。代わりに WITH XMLNAMESPACES を使用し、このプレフィックスを 1 回宣言してクエリで使用することもできます。

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