[アーティクル]
04/01/2012

パス式のステップでのノードテストの指定

パス式の軸ステップには、次のコンポーネントが含まれてます。

詳細については、「パス式 (XQuery)」を参照してください。

ノードテストとは条件で、パス式の軸ステップの 2 番目のコンポーネントです。ステップで選択されるすべてのノードは、この条件を満たす必要があります。パス式 /child::ProductDescription の場合、ノードテストは ProductDescription です。このステップでは、ProductDescription という名前の子要素ノードのみが取得されます。

ノードテストの条件には、次の情報を含めることができます。

ノード名。指定した名前を持つ、主ノード種別に属するノードのみが返されます。
ノード型。指定した型のノードのみが返されます。

注
XQuery パス式で指定されるノード名には、Transact-SQL クエリと同じ照合順序依存の規則は適用されません。常に大文字と小文字が区別されます。

ノードテストとしてのノード名

パス式のステップでノード名をノードテストとして指定する場合は、主ノード種別の概念を理解しておく必要があります。すべての軸 (child、parent、attribute) には、主ノード種別があります。次に例を示します。

attribute 軸には、属性のみを含めることができます。したがって、属性ノードが attribute 軸の主ノード種別になります。
その他の軸の場合、軸で選択されるノードに要素ノードを含めることができる場合は、要素がその軸の主ノード種別になります。

ノード名をノードテストとして指定すると、ステップから次の型のノードが返されます。

軸の主ノード種別に属するノード。
ノードテストに指定したのと同じ名前のノード。

たとえば、次のパス式について考えます。

child::ProductDescription

この 1 ステップの式では、child 軸とそのノード名 ProductDescription をノードテストとして指定しています。式は、child 軸の主ノード種別 (つまり要素ノード) に属する、ProductDescription という名前のノードのみを返します。

パス式 /child::PD:ProductDescription/child::PD:Features/descendant::*, には 3 つのステップがあります。これらのステップでは、child 軸と descendant 軸を指定しています。各ステップでは、ノード名がノードテストとして指定されています。3 番目のステップのワイルドカード文字 (*) は、descendant 軸の主ノード種別に属するすべてのノードを示しています。軸の主ノード種別により、選択されるノードの型が決まります。また、ノード名により、選択されるノードがフィルタ選択されます。

結果として、この式を ProductModel テーブルの製品カタログ XML ドキュメントに対して実行すると、<ProductDescription> 要素の <Features> 子要素ノードの子にあたるすべての要素ノードが取得されます。

パス式 /child::PD:ProductDescription/attribute::ProductModelID は、2 つのステップで構成されます。どちらのステップでも、ノード名をノードテストとして指定しています。また、2 番目のステップでは attribute 軸を使用します。したがって、各ステップでは、ノードテストに指定された名前を持つ、その軸の主ノード種別に属するノードが選択されます。そのため、この式は、<ProductDescription> 要素ノードの ProductModelID 属性ノードを返します。

ノードテストにノード名を指定する場合、次の例に示すように、ノードのローカル名やノードの名前空間プレフィックスにワイルドカード文字 (*) を使用することもできます。

declare @x xml
set @x = '
<greeting xmlns="ns1">
   <salutation>hello</salutation>
</greeting>
<greeting xmlns="ns2">
   <salutation>welcome</salutation>
</greeting>
<farewell xmlns="ns1" />'
select @x.query('//*:greeting')
select @x.query('declare namespace ns="ns1"; /ns:*')

ノードテストとしてのノード型

要素ノード以外のノード型を照会するには、ノード型テストを使用します。次の表に示すように、使用できるノード型テストは 4 つあります。

ノード型	戻り値	例
comment()	コメントノードの場合に True を返します。	following::comment() では、コンテキストノードの後にあるすべてのコメントノードが選択されます。
node()	ノードの種類に関係なく True を返します。	preceding::node() では、コンテキストノードの前にあるすべてのノードが選択されます。
processing-instruction()	処理命令ノードの場合は True を返します。	self::processing instruction() では、コンテキストノード内のすべての処理命令ノードが選択されます。
text()	テキストノードの場合は True を返します。	child::text() では、コンテキストノードの子にあたるテキストノードが選択されます。

text() や comment() などのノード型がノードテストに指定された場合は、軸の主ノード種別にかかわらず、ステップでは指定された種類のノードが返されます。たとえば、次のパス式は、コンテキストノードの子にあたるコメントノードのみを返します。

child::comment()

同様に、/child::ProductDescription/child::Features/child::comment() では、<ProductDescription> 要素ノードの <Features> 子要素ノードの子にあたるコメントノードが取得されます。

例

次の例では、ノード名とノードの種類を比較します。

A. ノード名とノード型をノードテストとしてパス式に指定した場合の結果

次の例では、簡単な XML ドキュメントが xml 型変数に代入されます。このドキュメントに対しては、複数のパス式を使用してクエリが実行されます。その後、結果が比較されます。

declare @x xml
set @x='
<a>
 <b>text1
   <c>text2
     <d>text3</d>
   </c>
 </b>
</a>'
select @x.query('
/child::a/child::b/descendant::*
')

この式では、<b> 要素ノードの子孫にあたる要素ノードが要求されます。

ノードテストのアスタリスク (*) は、ノード名のワイルドカード文字を示しています。descendant 軸の主ノード種別は要素ノードです。したがって、この式は、要素ノード <b> の子孫にあたるすべての要素ノードを返します。つまり、次の結果に示すように、要素ノード <c> と <d> が返されます。

<c>text2
     <d>text3</d>
</c>
<d>text3</d>

次のように、descendant 軸ではなく descendent-or-self 軸を指定すると、コンテキストノードとその子孫が返されます。

/child::a/child::b/descendant-or-self::*

この式は、要素ノード <b> とその子孫にあたる要素ノードを返します。子孫ノードを返すときに、descendant-or-self 軸の主ノード種別 (要素ノード型) により、返されるノードの種類が決まります。

結果を次に示します。

<b>text1
   <c>text2
     <d>text3</d>
   </c>
</b>

<c>text2
     <d>text3</d>
</c>

<d>text3</d>

前の式では、ワイルドカード文字をノード名として使用しました。代わりに、次の式に示すように node() 関数を使用できます。

/child::a/child::b/descendant::node()

node() はノード型なので、descendant 軸のすべてのノードが返されます。結果を次に示します。

text1
<c>text2
     <d>text3</d>
</c>
text2
<d>text3</d>
text3

さらに、descendant-or-self 軸と node() をノードテストに指定した場合は、すべての子孫、要素、テキストノード、およびコンテキストノードである <b> 要素が返されます。

<b>text1
   <c>text2
     <d>text3</d>
   </c>
</b>
text1
<c>text2
     <d>text3</d>
</c>
text2
<d>text3</d>
text3

B. ノードテストでのノード名の指定

次の例では、すべてのパス式でノード名をノードテストとして指定します。結果として、すべての式により、ノードテストに指定したノード名を持つ、軸の主ノード種別に属するノードが返されます。

次のクエリ式を実行すると、Production.ProductModel テーブルに格納されている製品カタログ XML ドキュメントから <Warranty> 要素が返されます。

SELECT CatalogDescription.query('
declare namespace PD="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";
declare namespace wm="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelWarrAndMain";
 /child::PD:ProductDescription/child::PD:Features/child::wm:Warranty
')
FROM Production.ProductModel
WHERE ProductModelID=19

上のクエリに関して、次の点に注意してください。

XQuery プロローグ内の namespace キーワードにより、クエリ本文で使用するプレフィックスが定義されています。XQuery プロローグの詳細については、「XQuery プロローグ」を参照してください。
パス式の中にある 3 つのすべてのステップで、child 軸とノードテストとしてのノード名が指定されています。
軸ステップの省略可能なステップ修飾子の部分は、式のどのステップにも指定されていません。

このクエリでは、<ProductDescription> 要素の <Features> 子要素の <Warranty> 子要素を返します。

結果を次に示します。

<wm:Warranty xmlns:wm="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelWarrAndMain">
  <wm:WarrantyPeriod>3 years</wm:WarrantyPeriod>
  <wm:Description>parts and labor</wm:Description>
</wm:Warranty>

次のクエリでは、パス式でノードテストにワイルドカード文字 (*) を指定しています。

SELECT CatalogDescription.query('
declare namespace PD="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";
declare namespace wm="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelWarrAndMain";
 /child::PD:ProductDescription/child::PD:Features/child::*
')
FROM Production.ProductModel
WHERE ProductModelID=19

ワイルドカード文字は、ノード名に対して指定されています。したがって、このクエリを実行すると、<ProductDescription> 要素ノードの <Features> 子要素ノードの子にあたる要素ノードがすべて返されます。

次のクエリは、ワイルドカード文字と共に名前空間が指定されている点を除けば、前のクエリと同じです。結果として、その名前空間に含まれるすべての子要素ノードが返されます。<Features> 要素には複数の名前空間の要素を含めることができることに注意してください。

SELECT CatalogDescription.query('
declare namespace PD="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";
declare namespace wm="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelWarrAndMain";
 /child::PD:ProductDescription/child::PD:Features/child::wm:*
')
FROM Production.ProductModel
WHERE ProductModelID=19

次のクエリに示すように、ワイルドカード文字を名前空間プレフィックスとして使用できます。

SELECT CatalogDescription.query('
declare namespace PD="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";
declare namespace wm="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelWarrAndMain";
 /child::PD:ProductDescription/child::PD:Features/child::*:Maintenance
')
FROM Production.ProductModel
WHERE ProductModelID=19

このクエリでは、製品カタログ XML ドキュメントからすべての名前空間の <Maintenance> 子要素ノードが返されます。

C. ノードテストでのノードの種類の指定

次の例では、すべてのパス式でノードの種類をノードテストとして指定します。結果として、すべての式がノードテストに指定した種類のノードを返します。

次のクエリでは、パス式で、3 番目のステップにノードの種類を指定しています。

SELECT CatalogDescription.query('
declare namespace PD="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";
declare namespace wm="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelWarrAndMain";
 /child::PD:ProductDescription/child::PD:Features/child::text()
')
FROM Production.ProductModel
WHERE ProductModelID=19

このクエリには、次の指定があります。

パス式には、スラッシュ (/) で区切られた 3 つのステップがあります。
これらの各ステップでは、child 軸を指定しています。
最初の 2 つのステップではノード名をノードテストに指定し、3 番目のステップではノードの種類をノードテストに指定しています。
この式は、<ProductDescription> 要素ノードの <Features> 子要素の子にあたるテキストノードを返します。

返されるテキストノードは 1 つだけです。結果を次に示します。

These are the product highlights.

次のクエリを実行すると、<ProductDescription> 要素の子にあたるコメントノードが返されます。

SELECT CatalogDescription.query('
declare namespace PD="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";
declare namespace wm="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelWarrAndMain";
 /child::PD:ProductDescription/child::comment()
')
FROM Production.ProductModel
WHERE ProductModelID=19

上のクエリに関して、次の点に注意してください。

2 番目のステップでは、ノードの種類をノードテストに指定しています。
結果として、この式は、<ProductDescription> 要素ノードの子にあたるコメントノードを返します。

結果を次に示します。

<!-- add one or more of these elements... one for each specific product in this product model -->
<!-- add any tags in <specifications> -->

次のクエリを実行すると、最上位の処理命令ノードが取得されます。

SELECT CatalogDescription.query('
declare namespace PD="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";
declare namespace wm="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelWarrAndMain";
 /child::processing-instruction()
')
FROM Production.ProductModel
WHERE ProductModelID=19

結果を次に示します。

<?xml-stylesheet href="ProductDescription.xsl" type="text/xsl"?>

processing-instruction() ノードテストには、文字列リテラルパラメータを渡すことができます。この場合、クエリは、名前属性の値が引数に指定された文字列リテラルと一致する処理命令を返します。

SELECT CatalogDescription.query('
declare namespace PD="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";
declare namespace wm="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelWarrAndMain";
 /child::processing-instruction("xml-stylesheet")
')
FROM Production.ProductModel
WHERE ProductModelID=19

実装の制限事項

次に、特定の制限事項を示します。

拡張された SequenceType ノードテストはサポートされません。
processing-instruction(name) はサポートされません。name は引用符で囲む必要があります。

次の方法で共有

パス式のステップでのノードテストの指定

ノードテストとしてのノード名

ノードテストとしてのノード型

例

A. ノード名とノード型をノードテストとしてパス式に指定した場合の結果

B. ノードテストでのノード名の指定

C. ノードテストでのノードの種類の指定

実装の制限事項

その他のリソース

次の方法で共有

パス式のステップでのノード テストの指定

ノード テストとしてのノード名

ノード テストとしてのノード型

例

A. ノード名とノード型をノード テストとしてパス式に指定した場合の結果

B. ノード テストでのノード名の指定

C. ノード テストでのノードの種類の指定

実装の制限事項

その他のリソース

パス式のステップでのノードテストの指定

ノードテストとしてのノード名

ノードテストとしてのノード型

A. ノード名とノード型をノードテストとしてパス式に指定した場合の結果

B. ノードテストでのノード名の指定

C. ノードテストでのノードの種類の指定