類型系統 (XQuery)

XQuery 對結構描述類型而言是一個強式類型語言，對於不具類型的資料而言是一個弱式類型語言。XQuery 的預先定義類型包括下列各項：

• http://www.w3.org/2001/XMLSchema 命名空間中 XML 結構描述的內建類型。

• http://www.w3.org/2004/07/xpath-datatypes 命名空間中定義的類型。

此主題也描述下列項目：

• 具類型的值與節點的字串值。

• data 函數 (XQuery) 和 string 函數 (XQuery)。

• 比對運算式傳回的序列類型。

XML 結構描述的內建類型

XML 結構描述的內建類型具有預先定義的命名空間前置詞 xs。其中一些類型包括 xs:integer 和 xs:string。這些內建類型都受到支援。當您建立 XML 結構描述集合時，可以使用這些類型。

查詢具類型的 XML 時，節點的靜態和動態類型是由被查詢的資料行或變數相關聯之 XML 結構描述集合所決定。如需靜態和動態類型的詳細資訊，請參閱＜運算式內容和查詢評估 (XQuery)＞。例如，下列查詢是針對具類型的 xml 資料行 (Instructions) 所指定。運算式使用 instance of 來確認所傳回之 LotSize 屬性的具類型值屬於 xs:decimal 類型。

SELECT Instructions.query('
   DECLARE namespace AWMI="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions";
   data(/AWMI:root[1]/AWMI:Location[@LocationID=10][1]/@LotSize)[1] instance of xs:decimal
') AS Result
FROM Production.ProductModel
WHERE ProductModelID=7

此類型資訊是由資料行相關聯的 XML 結構描述集合所提供。如需詳細資訊，請參閱＜在 AdventureWorks 資料庫中的 xml 資料類型表示法＞。

XPath 資料類型命名空間中定義的類型

http://www.w3.org/2004/07/xpath-datatypes 命名空間中定義的類型，具有預先定義的前置詞 xdt。下列適用於這些類型：

• 當您建立 XML 結構描述集合時，不能使用這些類型。這些類型是用在 XQuery 類型系統中，並用於XQuery 與靜態類型。您可以轉換成 xdt 命名空間中的不可部份完成類型，例如 xdt:untypedAtomic。

• 查詢不具類型的 XML 時，元素節點的靜態和動態類型是 xdt:untyped，而屬性值的類型是 xdt:untypedAtomic。query() 方法的結果會產生不具類型的 XML。這表示 XML 節點會分別以 xdt:untyped 和 xdt:untypedAtomic 傳回。

• xdt:dayTimeDuration 和 xdt:yearMonthDuration 類型不受支援。

在下列範例中，查詢是針對不具類型的 XML 變數所指定。運算式 data(/a[1]) 會傳回含有一個不可部份完成值的序列。data() 函數會傳回 <a> 元素的具類型值。因為要查詢的 XML 不具類型，所以傳回的值類型是 xdt:untypedAtomic。因此，instance of 傳回 true。

DECLARE @x xml
SET @x='<a>20</a>'
SELECT @x.query( 'data(/a[1]) instance of xdt:untypedAtomic' )

下列範例中的運算式 (/a[1]) 不會擷取具類型值，而會傳回一個元素 (<a> 元素) 的序列。instance of 運算式會使用元素測試來確認運算式傳回的值為 xdt:untyped type 的元素節點。

DECLARE @x xml
SET @x='<a>20</a>'
-- Is this an element node whose name is "a" and type is xdt:untyped.
SELECT @x.query( '/a[1] instance of element(a, xdt:untyped?)')
-- Is this an element node of type xdt:untyped.
SELECT @x.query( '/a[1] instance of element(*, xdt:untyped?)')
-- Is this an element node?
SELECT @x.query( '/a[1] instance of element()')

[!附註]

若您是查詢具類型的 XML 執行個體且查詢運算式包含父軸，則結果節點的靜態類型資訊就無法再使用。不過，動態類型仍與節點相關聯。

具類型值與字串值

每一個節點都有一個具類型值和一個字串值。若為具類型的 XML 資料，具類型值的類型是由被查詢的資料行或變數相關聯之 XML 結構描述集合來提供。若為不具類型的 XML 資料，具類型值的類型是 xdt:untypedAtomic。

您可以使用 data() 或 string() 函數來擷取節點的值：

• data 函數 (XQuery) 會傳回節點的具類型值。

• string 函數 (XQuery) 會傳回節點的字串值。

在下列 XML 結構描述集合中，定義了整數類型的 <root> 元素：

CREATE XML SCHEMA COLLECTION SC AS N'
<schema xmlns="http://www.w3.org/2001/XMLSchema">
      <element name="root" type="integer"/>
</schema>'
GO

在下列範例中，運算式會先擷取 /root[1] 的具類型值，然後再加 3。

DECLARE @x xml(SC)
SET @x='<root>5</root>'
SELECT @x.query('data(/root[1]) + 3')

在下一個範例中，運算式會失敗，因為運算式中的 string(/root[1]) 會傳回字串類型值。該值接著會傳遞給算術運算子，而此運算子只接受數值類型值做為其運算元。

-- Fails because the argument is string type (must be numeric primitive type).
DECLARE @x xml(SC)
SET @x='<root>5</root>'
SELECT @x.query('string(/root[1]) + 3')

下列範例計算 LaborHours 屬性的總計。data() 函數會從產品型號的所有 <Location> 元素中，擷取 LaborHours 屬性的具類型值。根據與 Instruction 資料行相關聯的 XML 結構描述，LaborHours 為 xs:decimal 類型。

SELECT Instructions.query(' 
DECLARE namespace AWMI="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions"; 
             sum(data(//AWMI:Location/@LaborHours)) 
') AS Result 
FROM Production.ProductModel 
WHERE ProductModelID=7

此查詢傳回的結果為 12.75。

[!附註]

在此範例中，明確使用 data() 函數只是為了方便解釋而已。如果沒有指定它，sum() 會隱含地套用 data() 函數來擷取節點的具類型值。

請參閱

其他資源

使用 SQL Server Profiler

XQuery 基本概念