共用方式為

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

  • 發行項

適用於：SQL Server Azure SQL 資料庫 Azure SQL 受控執行個體

針對 xml 資料類型的執行個體指定 XQuery。 結果為 xml 類型。 該方法會傳回不具類型的 XML 執行個體。

語法

query ('XQuery')

引數

XQuery
是字串類型的 XQuery 運算式，可查詢 XML 執行個體中的項目和屬性等 XML 節點。

範例

此節提供一些使用 xml 資料類型的 query() 方法之範例。

A. 針對 xml 類型變數使用 query() 方法

以下範例會宣告 xml 類型的 @myDoc 變數並指派 XML 執行個體給它。 query() 方法可用以指定針對文件的 XQuery。

查詢會擷取 <ProductDescription> 元素的 <Features> 子元素：

DECLARE @myDoc XML  
SET @myDoc = '<Root>  
<ProductDescription ProductID="1" ProductName="Road Bike">  
<Features>  
  <Warranty>1 year parts and labor</Warranty>  
  <Maintenance>3 year parts and labor extended maintenance is available</Maintenance>  
</Features>  
</ProductDescription>  
</Root>'  
SELECT @myDoc.query('/Root/ProductDescription/Features')

下列輸出顯示結果：

<Features>  
  <Warranty>1 year parts and labor</Warranty>  
  <Maintenance>3 year parts and labor extended maintenance is available</Maintenance>  
</Features>

B. 使用針對 XML 類型資料行的 query() 方法

在下列查詢中，query() 方法是用以指定 XQuery，以針對 AdventureWorks 資料庫中 xml 類型的 CatalogDescription 資料行進行查詢：

SELECT CatalogDescription.query('  
declare namespace PD="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";  
<Product ProductModelID="{ /PD:ProductDescription[1]/@ProductModelID }" />  
') as Result  
FROM Production.ProductModel  
where CatalogDescription.exist('  
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";  
     /PD:ProductDescription/PD:Features/wm:Warranty ') = 1

請注意，下列項目是從上一個查詢而來：

  • CatalogDescription 資料行是具類型的 xml 資料行，這表示它有與其建立關聯的結構描述集合。 在 XQuery 初構中，namespace 關鍵字可定義稍後要用於查詢主體的前置詞。

  • query() 方法會建構 XML，這是具有 ProductModelID 屬性的 <Product> 元素，其 ProductModelID 屬性值是從資料庫擷取而來。 如需 XML 建構的詳細資訊，請參閱 XML 建構 (XQuery)。

  • WHERE 子句的 exist() 方法 (XML 資料類型) 只會尋找 XML 中包含 <Warranty> 元素的資料列。 同樣地，namespace 關鍵字可定義兩個命名空間的前置詞。

下列輸出顯示部分結果：

<Product ProductModelID="19"/>   
<Product ProductModelID="23"/>   
...

請注意，query() 與 exist() 方法都會宣告 PD 前置詞。 在此情況下，您可以使用 WITH XMLNAMESPACES 先定義前置詞並在查詢中使用它。

WITH XMLNAMESPACES 
(  
   'https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription' AS PD,  
   'https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelWarrAndMain' AS WM
)  
SELECT CatalogDescription.query('<Product ProductModelID="{ /PD:ProductDescription[1]/@ProductModelID }" />')
       AS Result  
FROM Production.ProductModel  
WHERE CatalogDescription.exist('/PD:ProductDescription/PD:Features/WM:Warranty ') = 1;

另請參閱

使用 WITH XMLNAMESPACES 將命名空間加入至查詢
比較具類型的 XML 與不具類型的 XML
建立 XML 資料的執行個體
xml 資料類型方法
XML 資料修改語言 (XML DML)