xml 数据类型的 FOR XML 支持

如果 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 支持

帮助和信息

获取 SQL Server 2005 帮助