XML 类型_云原生数据库 PolarDB-阿里云帮助中心

本文介绍了XML类型的定义及相关语法。

xml 数据类型可以被用来存储 XML 数据。它比直接在一个 text 域中存储 XML 数据的优势在于，它会检查输入值的结构是不是良好，并且有支持函数用于在其上执行类型安全的操作。使用这种数据类型要求在安装时用 configure --with-libxml 选项编译。

xml 类型可以存储格式良好的遵循 XML 标准定义的“文档”，以及“内容”片段，它是通过引用更宽泛的“document node” XQuery 和 XPath 数据模型来定义的。大致上说，这意味着内容片段中可以有多于一个的顶层元素或字符节点。表达式 xmlvalue`` IS DOCUMENT 可以被用来评估一个特定的 xml 值是一个完整文档或者仅仅是一个文档片段。

创建XML值

要从字符数据中生成一个 xml 类型的值，可以使用函数 xmlparse ：

    XMLPARSE ( { DOCUMENT | CONTENT } value)

例子：

    XMLPARSE (DOCUMENT '<?xml version="1.0"?><book><title>Manual</title><chapter>...</chapter></book>')
    XMLPARSE (CONTENT 'abc<foo>bar</foo><bar>foo</bar>')

然而根据 SQL 标准这是唯一将字符串转换为 XML 值的方法，PostgreSQL 特有的语法：

    xml '<foo>bar</foo>'
    '<foo>bar</foo>'::xml

也可以被使用。

即便输入值指定了一个文档类型声明（DTD）， xml 类型也不根据 DTD 来验证输入值。目前也没有内建的支持用于根据其他 XML 模式语言（如 XML 模式）来进行验证。

作为一个逆操作，从 xml 产生一个字符串可以使用函数 xmlserialize ：

    XMLSERIALIZE ( { DOCUMENT | CONTENT } value AS type )

type 可以是 character 、 character varying 或 text （或者其中之一的一个别名）。再次地，根据 SQL 标准，这也是在 xml 类型和字符类型间做转换的唯一方法，但是 PostgreSQL 也允许你简单地造型这些值。

当一个字符串不是使用 XMLPARSE 造型成 xml 或者不是使用 XMLSERIALIZE 从 xml 造型得到，对于 DOCUMENT 和 CONTENT 两者的选择是根据“XML option” 会话配置参数决定的，它可以使用标准命令来设置：

    SET XML OPTION { DOCUMENT | CONTENT };

或者是更具有 PostgreSQL 风格的语法

    SET xmloption TO { DOCUMENT | CONTENT };

默认值是 CONTENT ，因此所有形式的 XML 数据都被允许。

编码处理

在客户端、服务器以及其中流过的 XML 数据上处理多字符编码时必须要注意。在使用文本模式向服务器传递查询以及向客户端传递查询结果（在普通模式）时，PostgreSQL 将所有在客户端和服务器之间传递的字符数据转换为目标端的字符编码。这也包括了表示 XML 值的串，正如上面的例子所述。这也通常意味着由于字符数据会在客户端和服务器之间传递时被转换成其他编码，包含在 XML 数据中的编码声明可能是无效的，因为内嵌的编码声明没有被改变。为了处理这种行为，包含在表示 xml 类型输入的字符串中包含的编码声明会被忽略，并且其内容被假定为当前服务器的编码。接着，为了正确处理，XML 数据的字符串必须以当前客户端编码从客户端发出。客户端负责在把文档发送给服务器之前将它们转换为当前客户端编码，或者适当地调整客户端编码。在输出时， xml 类型的值将不会有一个编码声明，并且客户端将会假设所有数据都是当前客户端编码。

在使用二进制模式传送查询参数给服务器以及传回查询结果给客户端时，不会执行编码转换，因此情况就有所不同。在这种情况下，XML 数据中的编码声明将被注意到，并且如果缺少编码声明时该数据会被假定为 UTF-8（由于 XML 标准的要求，注意 PostgreSQL 不支持 UTF-16）。在输出时，数据将会有一个编码声明来指定客户端编码，除非客户端编码为 UTF-8（这种情况下编码声明会被忽略）。

不用说，在 PostgreSQL 中处理 XML 数据产生错误的可能性更小，并且在 XML 数据编码、客户端编码和服务器编码三者相同时效率更高。因为 XML 数据在内部是以 UTF-8 处理的，如果服务器编码也是 UTF-8 时，计算效率将会最高。

创建XML值

编码处理

访问XML值