從 PostgreSQL 8.3 開始，核心伺服器中已有基於 SQL/XML 標準的 XML 相關功能。 該功能涵蓋 XML 語法檢查和 XPath 查詢，這也是此模組所做的，而且更多，但 API 完全不相容。 計劃在未來版本的 PostgreSQL 中移除此模組，以支持較新的標準 API，因此建議您嘗試轉換您的應用程式。 如果您發現此模組的某些功能無法透過較新的 API 以足夠的形式提供，請將您的問題說明給 <pgsql-hackers@lists.postgresql.org> 以便能夠解決此缺陷。

表 F.35 顯示了此模組提供的函數。 這些函數提供了簡單的 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 查詢，並將結果以表格形式傳回。 原始文件表格的主鍵欄位會作為結果的第一欄傳回，以便結果集可以輕鬆地用於聯結。 參數描述於表格 F.36。

這些參數（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 授權。