Начиная с PostgreSQL 8.3, в ядре сервера есть функциональность, связанная с XML, основанная на стандарте SQL/XML. Эта функциональность включает проверку синтаксиса XML и выполнение запросов XPath, что и делает данный модуль, а также предоставляет другие возможности. Однако, API не совместим с предыдущей версией. Планируется, что данный модуль будет удален в будущих версиях PostgreSQL в пользу нового стандартного API, поэтому рекомендуется попробовать преобразовать ваши приложения. Если вы обнаружите, что некоторая функциональность этого модуля недоступна в достаточной форме с использованием нового API, пожалуйста, опишите вашу проблему по адресу <pgsql-hackers@lists.postgresql.org>, чтобы недостаток мог быть устранен.

Таблица F.37 показывает функции, предоставляемые этим модулем. Эти функции обеспечивают простой разбор 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.38.

Эти параметры (за исключением строк XPath) просто подставляются в обычный SQL-оператор SELECT, поэтому у вас есть некоторая гибкость. Оператор

ВЫБРАТЬ <ключ>, <документ> ИЗ <отношение> ГДЕ <условие>

таким образом, эти параметры могут быть любыми допустимыми в этих конкретных местах. Результатом этого SELECT должно быть возвращение ровно двух столбцов (если вы не попытаетесь перечислить несколько полей для ключа или документа). Остерегайтесь, что этот упрощенный подход требует проверки любых пользовательских значений, чтобы избежать атак 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). Он имеет ту же лицензию BSD, что и PostgreSQL.