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

[アーティクル]
04/26/2023

適用対象:SQL Server Azure SQL Database Azure SQL Managed Instance

Nodes() メソッドは、細分化する場合に便利な xml データ型のインスタンスをリレーショナルデータにします。新しい行にマップされるノードを特定できます。

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

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

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

構文

nodes (XQuery) as Table(Column)

Note

SQL Server 2014 (12.x) 以前のバージョンの Transact-SQL 構文を確認するには、以前のバージョンのドキュメントを参照してください。

引数

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

テーブル(列)
結果の行セットのテーブル名と列名です。

解説

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

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="10" ... />  
             <Location LocationID="20" ... />  
             <Location LocationID="30" .../></root>  
1      <root><Location LocationID="10" ... />  
             <Location LocationID="20" ... />  
             <Location LocationID="30" .../></root>  
1      <root><Location LocationID="10" ... />  
             <Location LocationID="20" ... />  
             <Location LocationID="30" .../></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() メソッドを使用するシナリオは、XML の行セットビューを提供する OPENXML (Transact-SQL) を使用する場合と同じです。ただし、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 列に格納されている、自転車の製造手順を使用します。

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

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

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

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

各 <Location> の場所 ID
各 <step> の製造手順 (<Location> 子要素)

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

次のことを考慮してください。

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

CROSS APPLY により、ProductModel テーブルの各行に 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 ドキュメントに対し、Instructions テーブルの ProductModel 列に格納されている製造手順をクエリしています。このクエリでは、製品モデル 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

参照

WITH XMLNAMESPACES を使用したクエリへの名前空間の追加
 XML データのインスタンスの作成
 xml データ型メソッド

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

構文

引数

解説

例

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

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

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

参照

フィードバック

フィードバック

その他のリソース