创建 XML 数据的实例
适用于:SQL Server
Azure SQL 数据库
Azure SQL 托管实例
本文说明了如何生成 XML 实例。
在 SQL Server 中,可以通过下列方式生成 XML 实例:
- 对字符串实例进行类型转换。
- 将
SELECT
语句与FOR XML
子句结合使用。 - 使用常量赋值。
- 使用大容量加载。
类型转换字符串实例和二进制实例
可以将任何 SQL Server 字符串数据类型(如 [n]varchar、[n]char、[n]text、varbinary 和 image)分析成 xml 数据类型,方法是将字符串强制转换 (CAST
) 或转换 (CONVERT
) 成 xml 数据类型。 对非类型化的 XML 进行检查以确认其格式是否正确。 如果存在与 xml 类型关联的架构,也会执行验证。 有关详细信息,请参阅类型化 XML 与非类型化 XML 比较。
XML 文档可以采用不同的编码方式(例如,UTF-8、UTF-16 和 Windows-1252)进行编码。 下面概述了有关字符串和二进制源类型与 XML 文档编码进行交互的方式以及分析器行为方式的规则。
由于 nvarchar 采用为双字节 Unicode 编码(例如 UTF-16 或 UCS-2),因此 XML 分析器会将字符串值作为双字节 Unicode 编码 XML 文档或片断来处理。 XML 文档需要以双字节 Unicode 编码方式进行编码,同时需要与源数据类型兼容。 UTF-16 编码 XML 文档可以具有 UTF-16 字节顺序标记 (BOM),但是它不需要,因为源类型的上下文显式指出 UTF-16 编码 XML 文档只能是双字节 Unicode 编码文档。
varchar 字符串的内容被 XML 分析器视为单字节编码 XML 文档/片断。 由于 varchar 源字符串具有关联的代码页,因此如果 XML 本身中未指定显式编码,分析器使用该代码页进行编码。 如果 XML 实例具有 BOM 或编码声明,则 BOM 或声明需要与代码页保持一致,否则分析器会报告错误。
varbinary 的内容被视为码位流,它将直接被传递到 XML 分析器。 这样,XML 文档或片断就需要提供 BOM 或其他内联编码信息。 分析器仅查看该流来确定编码。 这意味着 UTF-16 编码的 XML 需要提供 UTF-16 BOM,而没有 BOM 且没有声明编码的实例将被解释为 UTF-8。
如果事先不知道 XML 文档的编码方式,并且数据在转换到 XML 之前被作为字符串或二进制数据而不是 XML 数据来传递,则应将数据作为 varbinary 处理。 例如,当使用 OpenRowset()
从 XML 文件读取数据时,应该指定将数据作为 varbinary(max) 值读取:
SELECT CAST(x AS XML)
FROM OpenRowset(BULK 'filename.xml', SINGLE_BLOB) R(x);
SQL Server 在内部以一种使用 UTF-16 编码的高效二进制表示形式来表示 XML。 用户提供的编码不会保留下来,但在分析过程中会考虑。
类型转换 CLR 用户定义类型
如果 CLR 用户定义类型具有 XML 序列化,则该类型的实例可以显式转换为 XML 数据类型。 有关 CLR 用户定义类型的 XML 序列化的更多信息,请参阅 从 CLR 数据库对象进行 XML 序列化。
类型化 XML 中的空格处理
在 SQL Server 中,如果元素内容中的空格出现在一组只有空格并由标记(如开始或结束标记)分隔的字符数据中,则会被忽略,因此不对其进行实体化。 (忽略 CDATA
部分。)这种空格处理方式与万维网联盟 (W3C) 发布的 XML 1.0 规格中介绍的空格处理方式不同。 这是因为 SQL Server 中的 XML 分析程序只识别有限数量的 DTD 子集(在 XML 1.0 中定义)。 有关 SQL Server 中支持的有限 DTD 子集的更多信息,请参阅 CAST 和 CONVERT。
默认情况下,如果以下任一选项为真,则 XML 解析器在将字符串数据转换为 XML 时会丢弃无关紧要的空格:
未对元素或其上级元素定义
xml:space
属性。某元素或其某一祖先元素上有效的
xml:space
属性具有默认值。
例如:
DECLARE @x XML;
SET @x = '<root> <child/> </root>';
SELECT @x;
下面是结果集:
<root><child/></root>
不过,您可以更改此行为。 若要为 xml DT 实例保留空格,请使用 CONVERT
运算符,并将其可选 style 参数的值设置为 1。 例如:
SELECT CONVERT(XML, N'<root> <child/> </root>', 1);
如果未使用 style 参数,或将其值设置为 0
,则转换 xml DT 实例时不保留无关紧要的空格。 有关在将字符串数据转换为 xml DT 实例时如何使用 CONVERT
运算符及其 style 参数的详细信息,请参阅 CAST 和 CONVERT。
示例:将字符串值转换为类型化的 xml 并将其赋给某列
下面的示例将包含 XML 片段的字符串变量转换为 xml 数据类型,然后将其存储在 xml 类型列中:
CREATE TABLE T (
c1 INT PRIMARY KEY,
c2 XML
);
GO
DECLARE @s VARCHAR(100);
SET @s = '<Cust><Fname>Andrew</Fname><Lname>Fuller</Lname></Cust>';
下面的插入操作将字符串隐式转换为 xml 类型:
INSERT INTO T
VALUES (3, @s);
可以使用 CAST
将字符串显式转换为 xml 类型:
INSERT INTO T
VALUES (3, CAST(@s AS XML));
另外,也可以使用 CONVERT
,如下面的代码示例所示:
INSERT INTO T
VALUES (3, CONVERT(XML, @s));
示例:将字符串转换为类型化的 XML 并将其赋给某个变量
在下面的示例中,将字符串转换为 xml 类型并赋给 xml 数据类型的变量:
DECLARE @x XML;
DECLARE @s VARCHAR(100);
SET @s = '<Cust><Fname>Andrew</Fname><Lname>Fuller</Lname></Cust>';
SET @x = CONVERT(XML, @s);
SELECT @x;
将 SELECT 语句与 FOR XML 子句结合使用
可以在 FOR XML
语句中使用 SELECT
子句以返回 XML 形式的结果。 例如:
DECLARE @xmlDoc XML;
SET @xmlDoc = (
SELECT Column1, Column2
FROM Table1, Table2
WHERE <some_condition>
FOR XML AUTO
)
...;
SELECT
语句将返回文本 XML 片段,该片段将在后面为 xml 数据类型变量赋值的过程中进行分析。
也可以在 FOR XML
子句中使用 FOR XML 查询中的 TYPE 指令,其直接返回 xml 类型的 FOR XML
查询结果:
DECLARE @xmlDoc XML;
SET @xmlDoc = (
SELECT ProductModelID, Name
FROM Production.ProductModel
WHERE ProductModelID = 19
FOR XML AUTO, TYPE
);
SELECT @xmlDoc;
下面是结果集:
<Production.ProductModel ProductModelID="19" Name="Mountain-100" />...
在下面的示例中,将 FOR XML
查询的类型化 xml 结果插入 xml 类型列中:
CREATE TABLE T1 (
c1 INT,
c2 XML
);
GO
INSERT T1 (c1, c2)
SELECT 1, (
SELECT ProductModelID, Name
FROM Production.ProductModel
WHERE ProductModelID = 19
FOR XML AUTO, TYPE
);
SELECT *
FROM T1;
GO
有关 FOR XML
的详细信息,请参阅 FOR XML (SQL Server)。
注意
SQL Server 会将 xml 数据类型实例作为不同服务器构造(例如,使用 FOR XML
指令或在其中使用 xml 数据类型从 SQL Server 数据库引擎列、变量和输出参数返回 XML 的 TYPE
查询)的结果返回到客户端。 在客户端应用程序代码中,ADO.NET 访问接口请求以二进制编码形式从服务器发送此 xml 数据类型信息。 但是,如果使用的是不带 FOR XML
指令的 TYPE
,则 XML 数据将作为字符串类型返回。 在任何情况下,客户端访问接口都始终能够处理其中任一种形式的 XML 内容。
使用常量赋值
可以在需要 xml 数据类型实例时使用字符串常量。 此分配与将字符串隐式 CAST
为 XML 相同。 例如:
DECLARE @xmlDoc XML;
SET @xmlDoc = '<Cust><Fname>Andrew</Fname><Lname>Fuller</Lname></Cust>';
-- Or
SET @xmlDoc = N'<?xml version="1.0" encoding="ucs-2"?><doc/>';
上面的示例中,将字符串隐式转换为 xml 数据类型,并将其赋给 xml 类型变量。
下面的示例将常量字符串插入 xml 类型列:
CREATE TABLE T (
c1 INT PRIMARY KEY,
c2 XML
);
INSERT INTO T
VALUES (3, '<Cust><Fname>Andrew</Fname><Lname>Fuller</Lname></Cust>');
注意
对于类型化的 XML,是针对指定的架构来验证 XML。 有关详细信息,请参阅类型化 XML 与非类型化 XML 比较。
使用大容量加载
通过增强的 OPENROWSET 功能,可以在数据库中大容量加载 XML 文档。 可以将文件中的 XML 实例大容量加载到数据库的 xml 类型列中。 有关实际示例,请参阅批量导入和导出 XML 文档的示例 (SQL Server)。 有关加载 XML 文档的详细信息,请参阅加载 XML 数据。
本节内容
文章 | 说明 |
---|---|
XML 查询选项和保留的数据 | 介绍了当 XML 实例存储在数据库中时未保留的部分。 |