共用方式為

  • 發行項

sql:column() 函數 (XQuery)

如＜在 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 插入陳述式之來源運算式內容中的 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 資料表所擷取。

  • 為了使查詢更有趣，將從 xml 類型的 CatalogDescription 資料行擷取 ProductModelName 屬性值。由於並非所有的產品型號都有儲存 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 初構中的 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。此資訊包含隸屬於特定產品型號 ProductModelID=19 的所有產品之 ProductID、ProductName、ProductPrice 以及 ProductModelName (如果有的話)。接著會將 XML 指派給 xml 類型的 @x 變數。

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