資料存取子函式 - 資料 （XQuery）
適用於：
SQL Server
傳回$arg 所 指定之每個專案的具型別值。
語法
fn:data ($arg as item()*) as xdt:untypedAtomic*
引數
$arg
將傳回具型別值的專案序列。
備註
下列適用于具類型的值：
不可部分完成值的具型別值是不可部分完成的值。
文位元組點的具型別值是文位元組點的字串值。
批註的具型別值是批註的字串值。
處理指示的具型別值是處理指示的內容，不含處理指示目標名稱。
檔節點的具型別值是其字串值。
下列適用于屬性和元素節點：
如果屬性節點是以 XML 架構類型輸入，則其具型別值會據以型別值。
如果屬性節點為不具類型，其具型別值會等於其字串值，當做 xdt：untypedAtomic 的 實例傳回。
如果專案節點尚未輸入，其具型別值會等於其字串值，而這個值會當做 xdt：untypedAtomic 的 實例傳回。
下列適用于具類型的專案節點：
如果專案具有簡單的內容類型， data（） 會傳回專案的具型別值。
如果節點是複雜類型，包括 xs：anyType， data（） 會傳回靜態錯誤。
雖然使用 data（） 函式經常是選擇性的，如下列範例所示，指定 data（） 函式會明確增加查詢可讀性。 如需詳細資訊，請參閱 XQuery 基本概念 。
您無法在建構的 XML 上指定 data（）， 如下列所示：
declare @x xml
set @x = ''
select @x.query('data(<SomeNode>value</SomeNode>)')
範例
本主題針對 AdventureWorks 資料庫中各種 xml 類型資料行中儲存的 XML 實例，提供 XQuery 範例。
A. 使用 data（） XQuery 函式來擷取節點的類型值
下列查詢說明如何使用 data（） 函式來擷取屬性、元素和文位元組點的值：
WITH XMLNAMESPACES (
'https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription' AS p1,
'https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelWarrAndMain' AS wm)
SELECT CatalogDescription.query(N'
for $pd in //p1:ProductDescription
return
<Root
ProductID = "{ data( ($pd//@ProductModelID)[1] ) }"
Feature = "{ data( ($pd/p1:Features/wm:Warranty/wm:Description)[1] ) }" >
</Root>
') as Result
FROM Production.ProductModel
WHERE ProductModelID = 19
以下是結果：
<Root ProductID="19" Feature="parts and labor"/>
如前所述，當您建構屬性時， data（） 函式是選擇性的。 如果您未指定 data（） 函式，則會隱含假設。 下列查詢會產生與上一個查詢相同的結果：
WITH XMLNAMESPACES (
'https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription' AS p1,
'https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelWarrAndMain' AS wm)
SELECT CatalogDescription.query('
for $pd in //p1:ProductDescription
return
<Root
ProductID = "{ ($pd/@ProductModelID)[1] }"
Feature = "{ ($pd/p1:Features/wm:Warranty/wm:Description)[1] }" >
</Root>
') as Result
FROM Production.ProductModel
WHERE ProductModelID = 19
下列範例說明需要 data（） 函式的 實例。
在下列查詢中， $pd/p1：Specifications/Material 會 <Material> 傳回 元素。 此外， data（$pd/p1：Specifications/ Material） 會傳回類型為 xdt：untypedAtomic 的字元資料類型，因為 <Material> 不是類型。 輸入不具類型時，data（） 的結果 會輸入為 xdt：untypedAtomic 。
SELECT CatalogDescription.query('
declare namespace p1="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";
for $pd in //p1:ProductDescription
return
<Root>
{ $pd/p1:Specifications/Material }
{ data($pd/p1:Specifications/Material) }
</Root>
') as Result
FROM Production.ProductModel
WHERE ProductModelID = 19
以下是結果：
<Root>
<Material>Almuminum Alloy</Material>Almuminum Alloy
</Root>
在下列查詢中， data（$pd/p1：Features/wm：Warranty） 會傳回靜態錯誤，因為 <Warranty> 是複雜的類型專案。
WITH XMLNAMESPACES (
'https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription' AS p1,
'https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelWarrAndMain' AS wm)
SELECT CatalogDescription.query('
<Root>
{ /p1:ProductDescription/p1:Features/wm:Warranty }
{ data(/p1:ProductDescription/p1:Features/wm:Warranty) }
</Root>
') as Result
FROM Production.ProductModel
WHERE ProductModelID = 23