nodes() 方法 (xml 資料類型)

發行項
05/04/2023

適用於：SQL Server Azure SQL Database Azure SQL 受控執行個體

當您想將 xml 資料類型執行個體切割成關聯式資料時，nodes() 方法會很有用。它可以讓您識別會對應至新資料列的節點。

每個 xml 資料類型執行個體都有隱含提供的內容節點。針對儲存在資料行或變數中的 XML 執行個體，這個節點是指文件節點。文件節點是位在每個 xml 資料類型執行個體最上方的隱含節點。

nodes() 方法的結果，會是一個包含原始 XML 執行個體之邏輯副本的資料列集。在這些邏輯複本中，每個資料列執行個體的內容節點，都會設成可使用查詢運算式來識別的節點之一。如此一來，後續的查詢便能夠相對於這些內容節點進行巡覽。

您可以從資料列集中擷取多個值。例如，您可以將 value() 方法套用至 nodes() 所傳回的資料列集，並從原始的 XML 執行個體中擷取多個值。 value() 方法在套用至 XML 執行個體時，只會傳回一個值。

Syntax

nodes (XQuery) as Table(Column)

注意

若要檢視 SQL Server 2014 （12.x）和舊版的 Transact-SQL 語法，請參閱舊版檔。

引數

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="10" ... />  
             <Location LocationID="20" ... />  
             <Location LocationID="30" .../></root>  
1      <root><Location LocationID="10" ... />  
             <Location LocationID="20" ... />  
             <Location LocationID="30" .../></root>  
1      <root><Location LocationID="10" ... />  
             <Location LocationID="20" ... />  
             <Location LocationID="30" .../></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> 中的 Location ID
擷取每個 <Location> 中的製造步驟 (<step> 子項目)

此查詢會傳回內容項目，其中在 '.' 方法中指定了 self::node() 的 query() 縮寫語法。

請注意：

nodes() 方法會套用至 Instructions 資料行，並傳回資料列集 T (C)。此資料列集包含原始製造指示文件的邏輯副本，並以 /root/Location 做為內容項目。

CROSS APPLY 會將 nodes() 套用在 ProductModel 資料表中的每個資料列，並且只傳回會產生結果集的資料列。

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

請注意：

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 資料類型方法

nodes() 方法 (xml 資料類型)

Syntax

引數

備註

範例

針對 xml 類型的變數來使用 nodes() 方法

針對 xml 類型的資料行來指定 nodes() 方法

將 nodes() 套用到由另一個 nodes() 方法傳回的資料列集

另請參閱

意見反應

意見反應

其他資源