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)