使用 xml 資料類型方法的指導方針

發行項
05/04/2023

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

本主題將描述使用 xml 資料類型方法的指導方針。

PRINT 陳述式

xml 資料類型方法不能用於 PRINT 陳述式中，如下列範例所示。 xml 資料類型方法會被視為子查詢，而 PRINT 陳述式中不允許有子查詢。因此，下列範例會傳回錯誤：

DECLARE @x XML
SET @x = '<root>Hello</root>'
PRINT @x.value('/root[1]', 'varchar(20)') -- will not work because this is treated as a subquery (select top 1 col from table)

解決方案是先將 value() 方法的結果指派到 xml 類型的變數中，然後再於查詢中指定變數。

DECLARE @x XML
DECLARE @c VARCHAR(max)
SET @x = '<root>Hello</root>'
SET @c = @x.value('/root[1]', 'VARCHAR(11)')
PRINT @c

GROUP BY 子句

xml 資料類型方法在內部會被視為子查詢。因為 GROUP BY 需要純量，且不允許彙總及子查詢，所以您不能在 GROUP BY 子句中指定 xml 資料類型方法。解決方案是，在其中呼叫使用 XML 方法的使用者自訂函數。

報告錯誤

報告錯誤時，xml 資料類型方法會以下列格式引發單一錯誤：

Msg errorNumber, Level levelNumber, State stateNumber:
XQuery [database.table.method]: description_of_error

例如：

Msg 2396, Level 16, State 1:
XQuery [xmldb_test.xmlcol.query()]: Attribute may not appear outside of an element

單一性檢查

如果編譯器無法判斷是否能在執行階段保證單一性，則需要單一性的尋找步驟、函數參數及運算子將會傳回錯誤。這個問題經常發生在不具類型的資料上。例如，查閱屬性時需要單一父元素。選擇單一父節點的序數即已足夠。評估 node()-value() 組合來擷取屬性值時，可能不需要指定序數。下一個範例將會加以說明。

範例：已知的單一性

在此範例中，nodes() 方法會為每個 <book> 元素各產生一列。在 <book> 節點上評估的 value() 方法會擷取 @genre 的值，而且因為是屬性，所以會是 singleton。

SELECT nref.value('@genre', 'VARCHAR(max)') LastName
FROM T CROSS APPLY xCol.nodes('//book') AS R(nref)

XML 結構描述可用來檢查具類型之 XML 的類型。如果在 XML 結構描述中將節點指定為單一性，編譯器就會使用該資訊，而且不會發生錯誤。否則，就需要有選擇單一節點的序數。尤其是使用 descendant-or-self 軸 (//) (例如在 /book//title 中時)，會使 <title> 元素的 singleton 基數推斷變得鬆散，即使 XML 結構描述指定要如此。因此，您應將其改寫成 (/book//title)[1]。

進行類型檢查時，務必持續留意 //first-name[1] 和 (//first-name)[1] 之間的差異。前者會傳回 <first-name> 節點的序列，其中每個節點都是同層級中最左邊的 <first-name>節點。後者會傳回 XML 執行個體中，文件順序中的第一個 singleton <first-name> 節點。

範例：使用 value()

下面這個在不具類型 XML 資料行上執行的查詢會導致靜態的編譯錯誤。這是因為 value() 預期以 singleton 節點作為第一個引數，而編譯器無法判斷在執行階段是否只會出現一個 <last-name> 節點：

SELECT xCol.value('//author/last-name', 'NVARCHAR(50)') LastName
FROM T

您可以考慮下面這個解決方案：

SELECT xCol.value('//author/last-name[1]', 'NVARCHAR(50)') LastName
FROM T

然而，這個解決方案並不能解決錯誤，因為每個 XML 執行個體中可能都會出現多個 <author> 節點。下列改寫方案可以奏效：

SELECT xCol.value('(//author/last-name/text())[1]', 'NVARCHAR(50)') LastName
FROM T

此查詢會傳回每個 XML 執行個體中第一個 <last-name> 元素的值。

另請參閱

xml 資料類型方法