[アーティクル]
09/28/2010

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

nodes() メソッドは、xml データ型のインスタンスをリレーショナルデータに細分化するときに役立ちます。また、このメソッドにより、新しい行にマップされるノードを特定できます。

すべての xml データ型のインスタンスには、コンテキストノードが暗黙に用意されています。列や変数に格納された XML インスタンスの場合は、ドキュメントノードがコンテキストノードになります。このドキュメントノードは、すべての xml データ型のインスタンスの最上位に位置する暗黙のノードです。

nodes() メソッドの結果は、元の XML インスタンスの論理コピーを含む行セットです。このような論理コピーでは、クエリ式で識別されるいずれかのノードが、すべての行インスタンスのコンテキストノードに設定されます。その結果、その後に実行されるクエリはこのようなコンテキストノードへ相対移動できます。

行セットからは、複数の値を取得できます。たとえば、value() メソッドを nodes() で返される行セットに適用し、元の XML インスタンスから複数の値を取得できます。value() メソッドを XML インスタンスに適用すると、値は 1 つしか返されないことに注意してください。

構文

nodes (XQuery) as Table(Column)

引数

XQuery
XQuery 式の文字列リテラルです。このクエリ式でノードが構築されると、構築されるノードが結果の行セットで公開されます。クエリ式の結果が空のシーケンスの場合、結果の行セットは空になります。クエリ式で、ノードではなくアトミック値が含まれたシーケンスが静的に返される場合は、静的エラーが発生します。
Table(Column)
結果の行セットのテーブル名と列名です。

説明

たとえば、次のテーブルがあるとします。

T (ProductModelID int, Instructions xml)

次の製造手順ドキュメントがこのテーブルに格納されます。記載しているのはドキュメントの一部のみです。このドキュメントには 3 つの製造場所が含まれていることに注意してください。

<root>
  <Location LocationID="10"...>
     <step>...</step>
     <step>...</step>
      ...
  </Location>
  <Location LocationID="20" ...>
       ...
  </Location>
  <Location LocationID="30" ...>
       ...
  </Location>
</root>

クエリ式 /root/Location を指定して nodes() メソッドを呼び出すと、次のように 3 つの行を持つ行セットが返されます。各行には元の XML ドキュメントの論理コピーが格納されており、いずれかの <Location> ノードがコンテキストアイテムに設定されます。

Product
ModelID      Instructions
----------------------------------
1       <root>
             <Location LocationID="20" ... />
             <Location LocationID="30" .../></root>
1      <root><Location LocationID="10" ... />
             
             <Location LocationID="30" .../></root>
1      <root><Location LocationID="10" ... />
             <Location LocationID="20" ... />
             </root>

この行セットには、xml データ型のメソッドを使用してクエリを実行できます。次のクエリを実行すると、生成された行ごとにコンテキストアイテムのサブツリーが抽出されます。

SELECT T2.Loc.query('.')
FROM   T
CROSS APPLY Instructions.nodes('/root/Location') as T2(Loc)

次に結果を示します。

ProductModelID  Instructions
----------------------------------
1        <Location LocationID="10" ... />
1        <Location LocationID="20" ... />
1        <Location LocationID="30" .../>

返された行セットでは型情報が保持されることに注意してください。nodes() メソッドの結果には、query()、value()、exist()、nodes() など、xml データ型のメソッドを適用できます。ただし、modify() メソッドを適用して XML インスタンスを変更することはできません。

また、行セットのコンテキストノードは具体化できません。つまり、このコンテキストノードは SELECT ステートメントでは使用できません。ただし、IS NULL と COUNT(*) では使用できます。

nodes() メソッドを使用するシナリオは、OPENXML (Transact-SQL) を使用する場合と同じです。したがって、XML の行セットビューが提供されます。ただし、XML ドキュメントの複数の行が含まれるテーブルに nodes() メソッドを使用するときは、カーソルを使用する必要はありません。

nodes() メソッドで返される行セットには名前が付いていないことに注意してください。したがって、別名を使用してこれらの行セットに明示的に名前を付ける必要があります。

nodes() 関数をユーザー定義関数の結果に直接適用することはできません。ユーザー定義のスカラ関数の結果に対して nodes() を使用するには、ユーザー定義のスカラ関数の結果を変数に代入するか、派生テーブルを使用して列の別名をユーザー定義のスカラ関数の戻り値に代入した後、CROSS APPLY を使用し、この別名から選択します。

次の例では、CROSS APPLY を使用し、ユーザー定義関数の結果から選択する方法を示します。

USE AdventureWorks;
GO

CREATE FUNCTION XTest()
RETURNS xml
AS
BEGIN
RETURN '<document/>';
END;
GO


SELECT A2.B.query('.')
FROM
(SELECT dbo.XTest()) AS A1(X) 
CROSS APPLY X.nodes('.') A2(B);
GO

DROP FUNCTION XTest;
GO

例

xml 型の変数に対する nodes() メソッドの使用

次の例では、<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>

xml 型の列に対する nodes() メソッドの指定

この例では、ProductModel テーブルの xml 型の Instructions 列に格納されている、自転車の製造手順を使用します。詳細については、「AdventureWorks データベースの 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>
...

別の nodes() メソッドにより返された行セットに対する nodes() の適用

次のコードでは、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

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

構文

引数

説明

例

xml 型の変数に対する nodes() メソッドの使用

xml 型の列に対する nodes() メソッドの指定

別の nodes() メソッドにより返された行セットに対する nodes() の適用

関連項目

概念

その他の技術情報

その他のリソース