自 PostgreSQL 8.3 起，核心服务器就提供了基于 SQL/XML 标准的 XML 相关功能。该功能覆盖了 XML 语法检查和 XPath 查询，也就是本模块所做的事情，而且能力更多；不过，两者的 API 完全不兼容。计划在未来的 PostgreSQL 版本中移除此模块，转而采用较新的标准 API，因此建议你尝试迁移应用程序。如果你发现本模块的某些功能在较新的 API 中还没有以足够完善的形式提供，请向 <pgsql-hackers@lists.postgresql.org> 说明你的问题，以便补齐这一不足。

Table F.38 显示了该模块提供的函数。这些函数提供简单直接的 XML 解析和 XPath 查询功能。

<toptag>
<itemtag>Value 1 which could be an XML fragment</itemtag>
<itemtag>Value 2....</itemtag>
</toptag>

xpath_table(text key, text document, text relation, text xpaths, text criteria) returns setof record

xpath_table 是一个表函数，它对一组文档中的每个文档执行一组 XPath 查询，并将结果作为表返回。原始文档表中的主键字段会作为结果的第一列返回，因此结果集可以方便地用于连接。参数说明见 Table F.39。

这些参数（XPath 字符串除外）只是直接替换进一个普通的 SQL SELECT 语句中，因此你有一定的灵活性 — 该语句为

SELECT <key>, <document> FROM <relation> WHERE <criteria>

因此，在这些特定位置上，任何合法内容都可以使用。该 SELECT 的结果必须恰好返回两列（除非你试图为 key 或 document 列出多个字段，否则都会如此）。请注意，这种简化做法要求你验证任何用户提供的值，以避免 SQL 注入攻击。

该函数必须用在 FROM 表达式中，并带有一个 AS 子句来指定输出列，例如

SELECT * FROM
xpath_table('article_id',
            'article_xml',
            'articles',
            '/article/author|/article/pages|/article/title',
            'date_entered > ''2003-01-01'' ')
AS t(article_id integer, author text, page_count integer, title text);

AS 子句定义了输出表中各列的名称和类型。第一列是 “key” 字段，其余各列对应 XPath 查询。如果 XPath 查询多于结果列，多出的查询将被忽略。如果结果列多于 XPath 查询，多出的列将为 NULL。

注意，这个示例把 page_count 结果列定义为整数。该函数内部只处理字符串表示，因此当你在输出中声明整数时，它会取 XPath 结果的字符串表示，并使用 PostgreSQL 输入函数将其转换为整数（或者 AS 子句要求的任何其他类型）。如果做不到这一点 — 例如结果为空 — 就会报错，因此如果你认为数据可能有问题，最好还是把列类型设为 text。

调用该函数的 SELECT 语句不一定非得只是 SELECT * — 它可以按名称引用输出列，或者将它们与其他表连接。该函数会生成一个虚拟表，你可以对它执行任何想要的操作（例如聚合、连接、排序等）。因此，更复杂一点的例子还可以是：

SELECT t.title, p.fullname, p.email
FROM xpath_table('article_id', 'article_xml', 'articles',
                 '/article/title|/article/author/@id',
                 'xpath_string(article_xml,''/article/@date'') > ''2003-03-20'' ')
       AS t(article_id integer, title text, author_id integer),
     tblPeopleInfo AS p
WHERE t.author_id = p.person_id;

当然，出于方便，你也可以把这一切封装到一个视图中。

CREATE TABLE test (
    id int PRIMARY KEY,
    xml text
);

INSERT INTO test VALUES (1, '<doc num="C1">
<line num="L1"><a>1</a><b>2</b><c>3</c></line>
<line num="L2"><a>11</a><b>22</b><c>33</c></line>
</doc>');

INSERT INTO test VALUES (2, '<doc num="C2">
<line num="L1"><a>111</a><b>222</b><c>333</c></line>
<line num="L2"><a>111</a><b>222</b><c>333</c></line>
</doc>');

SELECT * FROM
  xpath_table('id','xml','test',
              '/doc/@num|/doc/line/@num|/doc/line/a|/doc/line/b|/doc/line/c',
              'true')
  AS t(id int, doc_num varchar(10), line_num varchar(10), val1 int, val2 int, val3 int)
WHERE id = 1 ORDER BY doc_num, line_num

 id | doc_num | line_num | val1 | val2 | val3
----+---------+----------+------+------+------
  1 | C1      | L1       |    1 |    2 |    3
  1 |         | L2       |   11 |   22 |   33

SELECT t.*,i.doc_num FROM
  xpath_table('id', 'xml', 'test',
              '/doc/line/@num|/doc/line/a|/doc/line/b|/doc/line/c',
              'true')
    AS t(id int, line_num varchar(10), val1 int, val2 int, val3 int),
  xpath_table('id', 'xml', 'test', '/doc/@num', 'true')
    AS i(id int, doc_num varchar(10))
WHERE i.id=t.id AND i.id=1
ORDER BY doc_num, line_num;

 id | line_num | val1 | val2 | val3 | doc_num
----+----------+------+------+------+---------
  1 | L1       |    1 |    2 |    3 | C1
  1 | L2       |   11 |   22 |   33 | C1
(2 rows)

如果安装了 libxslt，则可使用下列函数：

xslt_process(text document, text stylesheet, text paramlist) returns text

John Gray <jgray@azuli.co.uk>

本模块由 Torchbox Ltd. (www.torchbox.com) 赞助开发。它采用与 PostgreSQL 相同的 BSD 许可证。