パス式 - ノードテストの指定

[アーティクル]
11/19/2024

適用対象: SQL Server

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

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

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

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

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

Note

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

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

パス式のステップでノード名をノードテストとして指定する場合は、主ノード種別の概念を理解しておく必要があります。すべての軸、子、親、または属性には、プリンシパルノードの種類があります。次に例を示します。

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

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

軸の主ノードの種類を持つノード。
ノードテストに指定したのと同じ名前のノード。

たとえば、次のパス式を考えてみましょう。

child::ProductDescription

この 1 ステップの式では、child 軸とそのノード名 ProductDescription をノードテストとして指定しています。式は、子軸、要素ノードのプリンシパルノードの種類であり、名前として ProductDescription を持つノードのみを返します。

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

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

パス式 /child::PD:ProductDescription/attribute::ProductModelIDは、2 つのステップで構成されます。どちらのステップでも、ノード名をノードテストとして指定しています。また、2 番目の手順では属性軸を使用します。そのため、各ステップでは、ノードテストとして指定された名前を持つ軸のプリンシパルノードの種類のノードが選択されます。したがって、この式は、<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> とその子孫にあたる要素ノードを返します。子孫ノードを返す場合、子孫または自己軸のプライマリノードの種類である要素ノードの種類によって、返されるノードの種類が決まります。

結果を次に示します。

<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()はノードタイプであるため、子孫軸のすべてのノードを受け取ります。結果を次に示します。

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 Prolog を参照してください。
パス式の 3 つのステップはすべて、ノードテストとして子軸とノード名を指定します。
軸ステップの省略可能なステップ修飾子部分は、式のどのステップでも指定されていません。

このクエリは、<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 つのステップがあります。
これらの各手順では、子軸を指定します。
最初の 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() ノードテストに渡すことができます。この場合、クエリは、name 属性値が引数で指定された文字列リテラルである処理命令を返します。

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: ノードテストでのノードの種類の指定