nodes() 方法(xml 数据类型)

如果要将 xml 数据类型实例拆分为关系数据,则 nodes() 方法非常有用。 它允许您标识将映射到新行的节点。

每个 xml 数据类型实例都有隐式提供的上下文节点。 对于在列或变量中存储的 XML 实例来说,它是文档节点。 文档节点是位于每个 xml 数据类型实例顶部的隐式节点。

nodes() 方法的结果是一个包含原始 XML 实例的逻辑副本的行集。 在这些逻辑副本中,每个行示例的上下文节点都被设置成由查询表达式标识的节点之一。这样,后续的查询可以浏览与这些上下文节点相关的节点。

您可以从行集中检索多个值。 例如,可以将 value() 方法应用于 nodes() 所返回的行集,从原始 XML 实例中检索多个值。 注意,当 value() 方法应用于 XML 实例时,它仅返回一个值。

语法

nodes (XQuery) as Table(Column)

参数

  • XQuery
    字符串文字,即一个 XQuery 表达式。 如果查询表达式构造节点,这些已构造的节点将在结果行集中显示。 如果查询表达式生成一个空序列,则行集将为空。 如果查询表达式静态生成一个包含原子值而不是节点的序列,将产生静态错误。

  • Table(Column)
    结果行集的表名称和列名称。

注释

例如,假设有下表:

T (ProductModelID int, Instructions xml)

表中存储了以下生产说明文档。 仅显示一个片段。 注意,文档中有三个生产位置。

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

带有查询表达式 /root/Location 的 nodes() 方法调用将返回一个行集,其中包含三行(每行都有一个原始 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" .../>

注意,返回的行集已对类型信息进行了维护。 可以将 xml 数据类型方法(例如 query()value()exist()nodes())应用于 nodes() 方法的结果。 但是,不能将 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() 方法

在以下示例中,XML 文档具有一个 <Root> 顶级元素和三个 <row> 子元素。 查询使用 nodes() 方法设置单独的上下文节点,每个 <row> 元素一个上下文节点。 nodes() 方法返回包含三行的行集。 每行都有一个原始 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"/>

对上下文节点应用父级取值函数将返回所有三行的 <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 表的 Instructions xml 类型列中。

在以下示例中,已对 ProductModel 表中 xml 类型的 Instructions 列指定 nodes() 方法。

nodes() 方法通过指定 /MI:root/MI:Location 路径,将 <Location> 元素设置为上下文节点。 结果行集包括原始文档的逻辑副本,每个副本对应文档中的一个 <Location> 节点,上下文节点设置为 <Location> 元素。 因此,nodes() 函数提供一组 <Location> 上下文节点。

query() 方法对此行集请求 self::node,从而在每行中返回 <Location> 元素。

在此示例中,查询在特定产品样式的生产说明文档中将每一个 <Location> 元素都设置为上下文节点。 您可以使用这些上下文节点来按照以下方式来检索值:

  • 查找每个 <Location> 中的位置 ID

  • 在每个 <Location> 中检索生产步骤(<step> 子元素)

在 query() 方法中,此查询返回上下文项,其中指定了 self::node() 的缩写语法 '.'。

注意以下事项:

  • 将 nodes() 方法应用于 Instructions 列,并且返回行集 T (C)。 此行集包含原始生产说明文档的逻辑副本,并且以 /root/Location 作为上下文项。

  • CROSS APPLY 将 nodes() 应用于 Instructions 表中的每行,并且仅返回生成结果集的行。

    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 前缀两次。 替代方法为,使用 WITH XMLNAMESPACES 声明前缀一次,便可将其用于查询:

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 数据类型方法