共用方式為

  • 發行項

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 類型資料行中。如需詳細資訊，請參閱＜在 AdventureWorks 資料庫中的 xml 資料類型表示法＞。

在下列範例中，會針對 ProductModel 資料表中 xml 類型的 Instructions 資料行來指定 nodes() 方法。

nodes() 方法藉由指定 /MI:root/MI:Location 路徑，將 <Location> 元素設為內容節點。結果資料列集包含原始文件的邏輯副本 (文件中的每個 <Location> 節點各有一個副本)，且其內容節點設為 <Location> 元素。因此，nodes() 函數會提供一組 <Location> 內容節點。

用於此資料列集的 query() 方法會要求 self::node，所以會傳回每個資料列的 <Location> 元素。

在此範例中，查詢在特定產品型號的製造指示文件中，將每個 <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 資料行中的製造指示。該查詢會傳回一個資料列集，其中包含產品型號識別碼、製造位置，以及製造步驟。

請注意下列事項：

  • 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