TYPE FOR XML 查询中的指令

适用于:SQL ServerAzure SQL 数据库Azure SQL 托管实例Microsoft Fabric 中的 SQL 数据库

SQL Server对 xml(Transact-SQL) 数据类型的支持,你可以选择通过指定指令请求将 FOR XML 查询的结果作为 TYPE 返回。 这样您便可以在服务器上处理 FOR XML 查询的结果。 例如,可以对其指定 Xquery,将结果分配给 xml 类型变量,或编写 嵌套 FOR XML 查询。

注意

SQL Server 通过不同的服务器端构造将 xml 数据类型的实例数据返回给客户端,例如使用 TYPE 指令的 FOR XML 查询,或者在使用 xml 数据类型从 SQL 表列和输出参数中返回 XML 实例数据值时。 在客户端应用程序代码中,ADO.NET 提供程序请求从服务器以二进制编码发送此 xml 数据类型信息。 但是,如果在不使用 TYPE 指令的情况下使用 FOR XML,XML 数据将作为字符串类型返回。 无论如何,客户端提供程序始终都能够处理这两种 XML 格式中的任意一种。 请注意,不带有 TYPE 指令的顶级 FOR XML 语句不能与游标一起使用。

示例

以下示例演示如何将 TYPE 指令与 FOR XML 查询配合使用。

以 XML 类型检索 FOR XML 查询结果

下面的查询检索 Contacts 表中的客户联系信息。 由于在 TYPE 中指定了 FOR XML指令,因此返回的结果的类型为 xml 。

注意

在 Azure SQL 数据库 和 Microsoft Fabric 中的 SQL 数据库中,该USE语句不可用。 相反,直接连接到目标数据库,运行剩余的代码样本。

USE AdventureWorks2022;
Go
SELECT BusinessEntityID, FirstName, LastName
FROM Person.Person
ORDER BY BusinessEntityID
FOR XML AUTO, TYPE;

下面是部分结果:

<Person.Person BusinessEntityID="1" FirstName="Ken" LastName="Sánchez"/>
<Person.Person BusinessEntityID="2" FirstName="Terri" LastName="Duffy"/>
...

将 FOR XML 查询结果赋给 xml 类型变量

在下面的示例中,一个 FOR XML 结果被赋给一个 xml 类型变量 @x。 该查询从 BusinessEntityIDxml FirstName的 LastName列检索联系信息(如 AdditionalContactInfo 、 、TYPE和其他电话号码)。 由于 FOR XML 子句指定了 TYPE 指令,因此 XML 返回为 xml 类型并赋给某个变量。

USE AdventureWorks2022;
GO
DECLARE @x xml;
SET @x = (
   SELECT BusinessEntityID,
          FirstName,
          LastName,
          AdditionalContactInfo.query('
declare namespace aci="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ContactInfo";
declare namespace act="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ContactTypes";
              //act:telephoneNumber/act:number') as MorePhoneNumbers
   FROM Person.Person
   FOR XML AUTO, TYPE);
SELECT @x;
GO

查询 FOR XML 查询的结果

FOR XML 查询返回 XML。 因此,可以将 xml 类型方法(例如 query() 和 value())应用于 FOR XML 查询返回的 XML 结果。

在下面的查询中, query() xml 数据类型的 方法用于查询 FOR XML 查询的结果。 有关详细信息,请参阅 query() 方法(xml 数据类型)。

USE AdventureWorks2022;
GO
SELECT (SELECT BusinessEntityID, FirstName, LastName, AdditionalContactInfo.query('
DECLARE namespace aci="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ContactInfo";
DECLARE namespace act="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ContactTypes";
//act:telephoneNumber/act:number
') AS PhoneNumbers
FROM Person.Person
FOR XML AUTO, TYPE).query('/Person.Person[1]');

内部 SELECT ... FOR XML 查询返回 xml 类型结果,外部 SELECT 将 query() 方法应用于该 xml 类型。 请注意指定的 TYPE 指令。

结果如下:

<Person.Person BusinessEntityID="1" FirstName="Ken" LastName="Sánchez">
  <PhoneNumbers>
    <act:number xmlns:act="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ContactTypes">111-111-1111</act:number>
    <act:number xmlns:act="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ContactTypes">112-111-1111</act:number>
  </PhoneNumbers>
</Person.Person>

在下面的查询中, value() xml 数据类型的 方法用于检索 SELECT...FOR XML 查询返回的 XML 结果中的值。 有关详细信息,请参阅 value() 方法(xml 数据类型)。

USE AdventureWorks2022;
GO
DECLARE @FirstPhoneFromAdditionalContactInfo varchar(40);
SELECT @FirstPhoneFromAdditionalContactInfo =
( SELECT BusinessEntityID, FirstName, LastName, AdditionalContactInfo.query('
declare namespace aci="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ContactInfo";
declare namespace act="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ContactTypes";
   //act:telephoneNumber/act:number
   ') AS PhoneNumbers
   FROM Person.Person Contact
   FOR XML AUTO, TYPE).value('
declare namespace act="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ContactTypes";
  /Contact[@BusinessEntityID="1"][1]/PhoneNumbers[1]/act:number[1]', 'varchar(40)'
);
SELECT @FirstPhoneFromAdditionalContactInfo;

value() 方法中的 XQuery 路径表达式检索 BusinessEntityID 为 1的客户联系人的第一个电话号码。

注意

TYPE如果未指定该指令,则 FOR XML 查询结果将返回为 nvarchar(max)类型。

使用 FOR XML 查询会得到 INSERT、UPDATE 和 DELETE(Transact-SQL DML)

下面的示例说明了如何在数据操作语言 (DML) 语句中使用 FOR XML 查询。 在此示例中, FOR XML 返回 xml 类型的实例。 INSERT 语句将此 XML 插入表中。

CREATE TABLE T1(intCol int, XmlCol xml);
GO
INSERT INTO T1
VALUES(1, '<Root><ProductDescription ProductModelID="1" /></Root>');
GO

CREATE TABLE T2(XmlCol xml)
GO
INSERT INTO T2(XmlCol)
SELECT (SELECT XmlCol.query('/Root')
        FROM T1
        FOR XML AUTO,TYPE);
GO