共用方式為

  • 發行項

sql:variable() 函數 (XQuery)

在 XQuery 運算式內公開含有 SQL 關聯值的變數。

語法

sql:variable("variableName") as xdt:anyAtomicType?

備註

如＜在 XML 資料中繫結關聯式資料＞主題中所述，您可以在使用 XML 資料類型方法來公開 XQuery 內的關聯值時，使用此函數。

例如，您可以使用 query() 方法，針對儲存在 xml 資料類型變數或資料行中的 XML 執行個體來指定查詢。有時候，您也會想要讓您的查詢作業使用 Transact-SQL 變數或參數中的值，以合併關聯式資料及 XML 資料。若要這麼做，就要使用 sql:variable 函數。

SQL 值將會對應至一個相對應的 XQuery 值，且其類型會是等同於相對應 SQL 類型的 XQuery 基底類型。

您只能參考 XML-DML 插入陳述式之來源運算式內容中的 xml 執行個體，否則您將無法參考 xml 類型或 Common Language Runtime (CLR) 使用者定義類型的值。

範例

A. 使用 sql:variable() 函數，將 Transact-SQL 變數值導入 XML

此範例會建構一個 XML 執行個體，由下列項目組成：

  • 取自非 XML 資料行的值 (ProductID)。會使用 sql:column() 函數在 XML 中繫結此值。

  • 取自其他資料表之非 XML 資料行的值 (ListPrice)。同樣地，使用 sql:column() 在 XML 中繫結此值。

  • 取自 Transact-SQL 變數的值 (DiscountPrice)。會使用 sql:variable() 方法在 XML 中繫結此值。

  • 取自 xml 類型資料行的值 (ProductModelName)，讓查詢的焦點更明確。

以下為查詢：

DECLARE @price money

SET @price=2500.00
SELECT ProductID, Production.ProductModel.ProductModelID,CatalogDescription.query('
declare namespace pd="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";

       <Product 
           ProductID="{ sql:column("Production.Product.ProductID") }"
           ProductModelID= "{ sql:column("Production.Product.ProductModelID") }"
           ProductModelName="{/pd:ProductDescription[1]/@ProductModelName }"
           ListPrice="{ sql:column("Production.Product.ListPrice") }"
           DiscountPrice="{ sql:variable("@price") }"
        />') 
FROM Production.Product 
JOIN Production.ProductModel
ON Production.Product.ProductModelID = Production.ProductModel.ProductModelID
WHERE ProductID=771

下列為上一個查詢的注意事項：

  • query() 方法中的 XQuery 會建構 XML。

  • namespace 關鍵字可用於在 XQuery 初構中定義命名空間前置詞。因為 CatalogDescription xml 類型資料行具有相關聯的結構描述，可從中擷取 ProductModelName 屬性值，所以可以完成此設定。

以下是結果：

<Product ProductID="771" ProductModelID="19" 
         ProductModelName="Mountain 100" 
         ListPrice="3399.99" DiscountPrice="2500" />