如果 FOR XML 查询在 SELECT 子句中指定了 xml 类型的列,列值将映射为返回的 XML 中的元素,不管是否指定了 ELEMENTS 指令。xml 类型的列中的任何 XML 声明都不是序列化的。
例如,下列查询将从 xml 类型的 AdditionalContactInfo 列中检索客户联系人信息(如 ContactID、FirstName 和 LastName 列以及电话号码)。
SELECT ContactID, FirstName, LastName, AdditionalContactInfo.query('
declare namespace act="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ContactTypes";
//act:telephoneNumber/act:number
') AS PhoneNumber
FROM Person.Contact
FOR XML AUTO, TYPE
因为查询没有指定 ELEMENTS 指令,所以除了从 xml 类型列中检索到的其他联系人信息值外,将把列值作为属性返回。其他信息值作为元素返回。
下面是部分结果:
<Contact ContactID="1" FirstName="Syed" LastName="Abbas">
<act:number xmlns:act=
"http://schemas.adventure-works.com/AdditionalContactTypes">
111-111-1111</act:number>
<act:number xmlns:act=
"http://schemas.adventure-works.com/AdditionalContactTypes">
112-111-1111</act:number>
</Contact>
<Contact ContactID="2" FirstName="Catherine" LastName="Abel">
...
</Contact>
...
如果为 XQuery 生成的 XML 列指定列别名,则该别名用于在 XQuery 生成的 XML 周围添加包装元素。例如,下列查询将 MorePhoneNumbers 指定为列别名:
SELECT ContactID, FirstName, LastName, AdditionalContactInfo.query('
declare namespace act="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ContactTypes";
//act:telephoneNumber/act:number
') as MorePhoneNumbers
FROM Person.Contact
FOR XML AUTO, TYPE
XQuery 返回的 XML 包装在 <MorePhoneNumbers
> 元素中,如下面的部分结果所示:
<Contact ContactID="1" FirstName="Syed" LastName="Abbas">
<MorePhoneNumbers>
<act:number xmlns:act="http://schemas.adventure-works.com/AdditionalContactTypes">111-111-1111</act:number>
<act:number xmlns:act="http://schemas.adventure-works.com/AdditionalContactTypes">112-111-1111</act:number>
</MorePhoneNumbers>
</Contact>
<Contact ContactID="2" FirstName="Catherine" LastName="Abel">
<MorePhoneNumbers>
...
</MorePhoneNumbers>
</Contact>
...
如果在查询中指定 ELEMENTS 指令,则 ContactID、LastName 和 FirstName 将作为生成的 XML 中的元素返回。
下面的示例说明了 FOR XML 处理逻辑不会从 xml 类型列中序列化 XML 数据中的任何 XML 声明:
create table t(i int, x xml)
go
insert into t values(1, '<?xml version="1.0" encoding="UTF-8" ?>
<Root SomeID="10" />')
select i, x
from t
for xml auto
结果如下。在结果中,XML 声明 <?xml version="1.0" encoding="UTF-8" ?
> 未被序列化。
<root>
<t i="1">
<x>
<Root SomeID="10" />
</x>
</t>
</root>
从用户定义的函数中返回 XML
可以使用 FOR XML 查询从用户定义函数返回 XML,该函数将返回下列任意一种结果:
- 含有单个 xml 类型列的表
- xml 类型的实例
例如,下面的用户定义的函数返回含有单个 xml 类型列的表:
CREATE FUNCTION MyUDF (@ProudctModelID int)
RETURNS @T TABLE
(
ProductDescription xml
)
AS
BEGIN
INSERT @T
SELECT CatalogDescription.query('
declare namespace PD="https://www.adventure-works.com/schemas/products/description";
//PD:ProductDescription ')
FROM Production.ProductModel
WHERE ProductModelID = @ProudctModelID
RETURN
END
您可以执行用户定义的函数并查询由它返回的表。在本示例中,通过查询表返回的 XML 被分配给一个 xml 类型的变量。
declare @x xml
set @x = (SELECT * FROM MyUDF(19))
select @x
这是用户定义函数的另一个示例。此用户定义的函数将返回一个 xml 类型的实例。在本示例中,用户定义的函数将返回一个类型化的 XML 实例,因为指定了架构命名空间。
drop function MyUDF4
go
CREATE FUNCTION MyUDF4 (@ProductModelID int)
RETURNS xml ([Production].[ProductDescriptionSchemaCollection])
AS
BEGIN
declare @x xml
set @x = ( SELECT CatalogDescription
FROM Production.ProductModel
WHERE ProductModelID = @ProductModelID )
return @x
END
由用户定义的函数返回的 XML 可以被分配给以下的 xml 类型的变量:
declare @x xml
SELECT @x= dbo.MyUDF4 (19)
select @x
请参阅
参考
各种 SQL Server 数据类型的 FOR XML 支持