指定路径表达式步骤中的节点测试

在下面的示例中，将把一个简单 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>

如果指定了 descendent-or-self 轴而不是 descendant 轴，则将返回上下文节点及其后代：

/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

以下示例将指定节点名作为所有路径表达式中的节点测试。因此，所有表达式都将返回属于轴的主要节点类型的、具有节点测试中所指定的节点名的节点。

下面的查询表达式将从存储在 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 prolog 中的 namespace 关键字定义了查询主体所使用的前缀。有关 XQuery prolog 的详细信息，请参阅 XQuery Prolog。

• 路径表达式中的全部三个步骤都指定 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> 元素节点。

以下示例将指定节点类型作为路径表达式中的节点测试。因此，所有表达式都将返回节点测试中所指定类型的节点。

在下面的查询中，路径表达式在其第三个步骤中指定了一个节点类型：

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

在下一个查询中，指定了下列内容：

• 路径表达式包含三个步骤，它们用斜杠 (/) 分隔。

• 每个步骤指定了一个 child 轴。

• 前两个步骤指定节点名作为节点测试，第三个步骤指定节点类型作为节点测试。

• 表达式将返回 <ProductDescription> 元素节点的 <Features> 元素子级的文本节点子级。

仅返回了一个文本节点。结果如下：

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

请注意上述查询的以下方面：

• 第二个步骤指定节点类型作为节点测试。

• 因此，表达式将返回 <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