XQuery 擴充函式 - sql:column()
適用於：
SQL Server
如系結關係型數據內部 XML 主題所述，當您使用 XML 數據類型方法在 XQuery 內公開關係型值時，可以使用 sql：column（） 函式。
例如， query（） 方法 （XML 數據類型） 是用來針對儲存在 xml 類型的變數或資料行中的 XML 實例指定查詢。 有時候，您可能也會希望查詢使用來自另一個非 XML 資料行的值，將關係型和 XML 數據結合在一起。 若要這樣做，請使用 sql：column（） 函式。
SQL 值會對應至對應的 XQuery 值，而且其類型會是相當於對應 SQL 類型的 XQuery 基底類型。
語法
sql:column("columnName")
備註
請注意，XQuery 內 sql：column（） 函式中所指定數據行的參考是指正在處理的數據列中的數據行。
在 SQL Server 中，您只能參考 XML-DML insert 語句之來源表示式內容中的 xml 實例;否則，您無法參考 xml 或 CLR 使用者定義型別的數據行。
JOIN 作業不支援 sql：column（） 函式。 您可以改用APPLY作業。
範例
A. 使用 sql：column（） 在 XML 內擷取關係型值
在建構 XML 時，下列範例說明如何從非 XML 關係型數據行擷取值，以系結 XML 和關係型數據。
此查詢會建構具有下列格式的 XML：
<Product ProductID="771" ProductName="Mountain-100 Silver, 38" ProductPrice="3399.99" ProductModelID="19"
ProductModelName="Mountain 100" />
請注意下列建構的 XML：
ProductID、ProductName 和 ProductPrice 屬性值是從 Product 數據表取得。
ProductModelID 屬性值是從 ProductModel 數據表擷取。
為了讓查詢更有趣，ProductModelName 屬性值是從 xml 類型的 CatalogDescription 數據行取得。 因為 XML 產品模型目錄資訊並未儲存給所有產品模型，
if所以語句只會在存在時擷取值。SELECT P.ProductID, CatalogDescription.query(' declare namespace pd="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription"; <Product ProductID= "{ sql:column("P.ProductID") }" ProductName= "{ sql:column("P.Name") }" ProductPrice= "{ sql:column("P.ListPrice") }" ProductModelID= "{ sql:column("PM.ProductModelID") }" > { if (not(empty(/pd:ProductDescription))) then attribute ProductModelName { /pd:ProductDescription[1]/@ProductModelName } else () } </Product> ') as Result FROM Production.ProductModel PM, Production.Product P WHERE PM.ProductModelID = P.ProductModelID AND CatalogDescription is not NULL ORDER By PM.ProductModelID
請注意下列項目是從上一個查詢而來：
因為值是從兩個不同的數據表擷取，FROM 子句會指定兩個數據表。 WHERE 子句中的條件會篩選結果，並只擷取產品模型具有目錄描述的產品。
XQuery Prolog 中的 namespace 關鍵詞會定義用於查詢主體的 XML 命名空間前置詞 “pd”。 請注意，數據表別名 「P」 和 「PM」 定義於查詢本身的 FROM 子句中。
sql：column（） 函式可用來將非 XML 值帶入 XML 內。
以下是部份結果：
ProductID Result
-----------------------------------------------------------------
771 <Product ProductID="771" ProductName="Mountain-100 Silver, 38"
ProductPrice="3399.99" ProductModelID="19"
ProductModelName="Mountain 100" />
...
下列查詢會建構包含產品特定資訊的 XML。 此資訊包括 ProductID、ProductName、ProductPrice，如果可用，則屬於特定產品型號 ProductModelID=19 的所有產品的 ProductModelName。 然後，XML 會指派給 @x xml 類型的變數。
declare @x xml
SELECT @x = CatalogDescription.query('
declare namespace pd="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";
<Product
ProductID= "{ sql:column("P.ProductID") }"
ProductName= "{ sql:column("P.Name") }"
ProductPrice= "{ sql:column("P.ListPrice") }"
ProductModelID= "{ sql:column("PM.ProductModelID") }" >
{ if (not(empty(/pd:ProductDescription))) then
attribute ProductModelName { /pd:ProductDescription[1]/@ProductModelName }
else
()
}
</Product>
')
FROM Production.ProductModel PM, Production.Product P
WHERE PM.ProductModelID = P.ProductModelID
And P.ProductModelID = 19
select @x
另請參閱
SQL Server XQuery 延伸模組函式
比較具類型的 XML 與不具類型的 XML
XML 資料 (SQL Server)
建立 XML 資料的執行個體
xml 資料類型方法
XML 資料修改語言 (XML DML)