XQuery 扩展函数 - sql:column()

项目
04/03/2023

如在 XML 中绑定关系数据主题中所述，在使用 XML 数据类型方法在 XQuery 中公开关系值时，可以使用 sql：column ( () 函数。

例如， xml 数据类型 (query () 方法) 用于指定针对 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 表中获取的。
从 ProductModel 表检索 ProductModelID 属性值。

为了使查询更有趣，可从 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 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 分配给 @xxml 类型的变量。

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)

通过

XQuery 扩展函数 - sql:column()

语法

备注

示例

A. 使用 sql:column() 检索 XML 中的关系值

另请参阅

反馈

其他资源