FOR XML (SQL Server)

适用于:SQL Server Azure SQL 数据库 Azure SQL 托管实例

SELECT 查询将结果作为行集返回。 (可选操作)您可以通过在 SQL 查询中指定 FOR XML 子句,从而将该查询的正式结果作为 XML 来检索。 FOR XML 子句可以用在顶级查询和子查询中。 顶级 FOR XML 子句只能用在 SELECT 语句中。 在子查询中,FOR XML 可以在 INSERTUPDATEDELETE 语句中使用。 FOR XML 还可以用在赋值语句中。

FOR XML 子句中,指定以下模式之一:

  • RAW
  • AUTO
  • EXPLICIT
  • PATH

RAW 模式将为 <row> 语句所返回行集中的每行生成一个 SELECT 元素。 可以通过编写嵌套 FOR XML 查询来生成 XML 层次结构。

AUTO 模式将基于指定 SELECT 语句的方式来使用试探性方法在 XML 结果中生成嵌套。 您对生成的 XML 的形状具有最低限度的控制能力。 除了 FOR XML 模式的试探性方法生成的 XML 形状之外,还可以编写 AUTO 查询来生成 XML 层次结构。

EXPLICIT 模式允许对 XML 的形状进行更多控制。 您可以随意混合属性和元素来确定 XML 的形状。 由于执行查询而生成的结果行集需要具有特定的格式。 此行集格式随后将映射为 XML 形状。 使用 EXPLICIT 模式能够随意混合属性和元素、创建包装和嵌套的复杂属性、创建用空格分隔的值(例如 OrderID 属性可能具有一列排序顺序 ID 值)以及混合内容。

但是,编写 EXPLICIT 模式的查询会比较麻烦。 可以使用某些新的 FOR XML 功能(例如编写嵌套 FOR XML RAWAUTOPATH 模式查询和 TYPE 指令),而不使用 EXPLICIT 模式来生成层次结构。 嵌套 FOR XML 查询可以生成使用 EXPLICIT 模式可生成的任何 XML。 有关详细信息,请参阅 使用嵌套的 FOR XML 查询FOR XML 查询中的 TYPE 指令

PATH 模式与嵌套 FOR XML 查询功能一起以较简单的方式提供了 EXPLICIT 模式的灵活性。

仅当执行设置了这些模式的查询时,这些模式才有效。 它们不会影响以后执行的任何查询的结果。

FOR XML 对于与 FOR BROWSE 子句一起使用的任何选择都无效。

示例

下面的 SELECT 语句将从 Sales.Customer 数据库的 Sales.SalesOrderHeaderAdventureWorks2022 表中检索信息。 此查询在 AUTO 子句中指定了 FOR XML 模式:

USE AdventureWorks2022;
GO

SELECT Cust.CustomerID,
    OrderHeader.CustomerID,
    OrderHeader.SalesOrderID,
    OrderHeader.STATUS
FROM Sales.Customer Cust
INNER JOIN Sales.SalesOrderHeader OrderHeader
    ON Cust.CustomerID = OrderHeader.CustomerID
FOR XML AUTO;

FOR XML 子句和服务器名称

如果带 SELECT 子句的 FOR XML 语句在查询中指定了一个由四部分组成的名称,则在本地计算机上执行查询时,所得 XML 文档中将不返回该服务器名称。 但在网络服务器上执行该查询时,此服务器名称将作为由四部分组成的名称返回。

例如,请考虑下面的查询:

SELECT TOP 1 LastName
FROM ServerName.AdventureWorks2022.Person.Person
FOR XML AUTO;

“本地服务器”:如果 ServerName 是本地服务器,此查询返回以下文本:

<AdventureWorks2022.Person.Person LastName="Achong" />

“网络服务器”:如果 ServerName 是网络服务器,此查询返回以下文本:

<ServerName.AdventureWorks2022.Person.Person LastName="Achong" />

“避免歧义”:通过指定如下别名可以避免这种潜在的二义性:

SELECT TOP 1 LastName
FROM ServerName.AdventureWorks2022.Person.Person x
FOR XML AUTO;

现在,无法消除歧义的查询返回以下文本:

<x LastName="Achong"/>