xpath ( xpath text, xml xml [, nsarray text[] ] ) → xml[]

函数 xpath 针对 XML 值 xml 评估 XPath 1.0 表达式 xpath（作为文本提供）。它返回一个 XML 值数组，对应于 XPath 表达式生成的节点集。如果 XPath 表达式返回标量值而不是节点集，则返回一个单元素数组。

第二个参数必须是格式良好的 XML 文档。特别是，它必须具有单个根节点元素。

函数的可选第三个参数是命名空间映射的数组。该数组应为二维text数组，其中第二轴的长度等于 2（即，它应为数组的数组，每个数组恰好包含 2 个元素）。每个数组条目的第一个元素是命名空间名称（别名），第二个元素是命名空间 URI。不需要此数组中提供的别名与 XML 文档本身中使用的别名相同（换句话说，在 XML 文档和xpath函数上下文中，别名都是局部）。

示例

SELECT xpath('/my:a/text()', '<my:a xmlns:my="http://example.com">test</my:a>',
             ARRAY[ARRAY['my', 'http://example.com']]);

 xpath
--------
 {test}
(1 row)

要处理默认（匿名）命名空间，请执行类似以下操作

SELECT xpath('//mydefns:b/text()', '<a xmlns="http://example.com"><b>test</b></a>',
             ARRAY[ARRAY['mydefns', 'http://example.com']]);

 xpath
--------
 {test}
(1 row)

xpath_exists ( xpath text, xml xml [, nsarray text[] ] ) → boolean

函数xpath_exists是xpath函数的专门形式。此函数不会返回满足 XPath 1.0 表达式的各个 XML 值，而是返回一个布尔值，指示查询是否得到满足（具体来说，是否产生了除空节点集之外的任何值）。此函数等效于XMLEXISTS谓词，不同之处在于它还支持命名空间映射参数。

示例

SELECT xpath_exists('/my:a/text()', '<my:a xmlns:my="http://example.com">test</my:a>',
                     ARRAY[ARRAY['my', 'http://example.com']]);

 xpath_exists
--------------
 t
(1 row)

XMLTABLE (
    [ XMLNAMESPACES ( namespace_uri AS namespace_name [, ...] ), ]
    row_expression PASSING [BY {REF|VALUE}] document_expression [BY {REF|VALUE}]
    COLUMNS name { type [PATH column_expression] [DEFAULT default_expression] [NOT NULL | NULL]
                  | FOR ORDINALITY }
            [, ...]
) → setof record

xmltable表达式基于 XML 值、用于提取行的 XPath 筛选器和一组列定义生成一个表。虽然它在语法上类似于函数，但它只能作为查询的FROM子句中的表出现。

可选的XMLNAMESPACES子句给出了一个逗号分隔的命名空间定义列表，其中每个namespace_uri都是text表达式，每个namespace_name都是一个简单标识符。它指定文档中使用的 XML 命名空间及其别名。目前不支持默认命名空间规范。

必需的row_expression参数是一个 XPath 1.0 表达式（以text给出），它经过评估，将 XML 值document_expression作为其上下文项传递，以获取一组 XML 节点。这些节点是xmltable转换为输出行的内容。如果document_expression为 null，或者如果row_expression产生一个空节点集或除节点集之外的任何值，则不会产生任何行。

document_expression为row_expression提供上下文项。它必须是一个格式良好的 XML 文档；不接受片段/林。如第 D.3.2 节中所述，接受BY REF和BY VALUE子句，但会忽略它们。

在 SQL 标准中，xmltable 函数评估 XML 查询语言中的表达式，但 PostgreSQL 只允许 XPath 1.0 表达式，如 第 D.3.1 节 所述。

必需的 COLUMNS 子句指定将在输出表中生成的列。有关格式，请参见上面的语法摘要。每个列都需要一个名称，还需要一个数据类型（除非指定了 FOR ORDINALITY，在这种情况下，类型 integer 是隐式的）。路径、默认值和可空性子句是可选的。

标记为 FOR ORDINALITY 的列将使用行号填充，从 1 开始，按照从 row_expression 的结果节点集检索到的节点的顺序。最多可以将一列标记为 FOR ORDINALITY。

一列的 column_expression 是 XPath 1.0 表达式，它针对每一行进行评估，其中 row_expression 结果作为其上下文项的当前节点，以查找该列的值。如果没有给出 column_expression，则列名将用作隐式路径。

如果一列的 XPath 表达式返回非 XML 值（在 XPath 1.0 中仅限于字符串、布尔值或双精度），并且该列的 PostgreSQL 类型不是 xml，则该列将被设置为好像通过将该值的字符串表示形式分配给 PostgreSQL 类型一样。（如果该值是布尔值，则其字符串表示形式将被视为 1 或 0，如果输出列的类型类别是数字，否则为 true 或 false。）

如果一列的 XPath 表达式返回一组非空 XML 节点，并且该列的 PostgreSQL 类型是 xml，则该列将被准确地分配表达式结果，如果它是文档或内容形式。^[8]

分配给 xml 输出列的非 XML 结果会生成内容，一个包含结果字符串值的文本节点。分配给任何其他类型的列的 XML 结果不能有多个节点，否则会引发错误。如果恰好有一个节点，则该列将被设置为好像通过将该节点的字符串值（如 XPath 1.0 string 函数所定义）分配给 PostgreSQL 类型一样。

XML 元素的字符串值是该元素及其后代中包含的所有文本节点按文档顺序连接的结果。没有后代文本节点的元素的字符串值为空字符串（不是 NULL）。将忽略所有 xsi:nil 属性。请注意，两个非文本元素之间的仅包含空白的 text() 节点将被保留，并且 text() 节点上的前导空白不会被展平。可以参考 XPath 1.0 string 函数了解定义其他 XML 节点类型和非 XML 值的字符串值的规则。

此处介绍的转换规则并非完全符合 SQL 标准，如 第 D.3.1.3 节 所述。

如果路径表达式对给定行返回一个空节点集（通常在不匹配时），则该列将被设置为 NULL，除非指定了 default_expression；然后使用评估该表达式得到的值。

在调用 xmltable 时，default_expression 不会立即被评估，而是在每次需要为该列指定默认值时被评估。如果表达式符合稳定或不可变的条件，则可以跳过重复评估。这意味着你可以在 default_expression 中使用易失函数，如 nextval。

可以将列标记为 NOT NULL。如果 NOT NULL 列的 column_expression 与任何内容都不匹配，并且没有 DEFAULT 或 default_expression 也评估为 null，则会报告一个错误。

示例

CREATE TABLE xmldata AS SELECT
xml $$
<ROWS>
  <ROW id="1">
    <COUNTRY_ID>AU</COUNTRY_ID>
    <COUNTRY_NAME>Australia</COUNTRY_NAME>
  </ROW>
  <ROW id="5">
    <COUNTRY_ID>JP</COUNTRY_ID>
    <COUNTRY_NAME>Japan</COUNTRY_NAME>
    <PREMIER_NAME>Shinzo Abe</PREMIER_NAME>
    <SIZE unit="sq_mi">145935</SIZE>
  </ROW>
  <ROW id="6">
    <COUNTRY_ID>SG</COUNTRY_ID>
    <COUNTRY_NAME>Singapore</COUNTRY_NAME>
    <SIZE unit="sq_km">697</SIZE>
  </ROW>
</ROWS>
$$ AS data;

SELECT xmltable.*
  FROM xmldata,
       XMLTABLE('//ROWS/ROW'
                PASSING data
                COLUMNS id int PATH '@id',
                        ordinality FOR ORDINALITY,
                        "COUNTRY_NAME" text,
                        country_id text PATH 'COUNTRY_ID',
                        size_sq_km float PATH 'SIZE[@unit = "sq_km"]',
                        size_other text PATH
                             'concat(SIZE[@unit!="sq_km"], " ", SIZE[@unit!="sq_km"]/@unit)',
                        premier_name text PATH 'PREMIER_NAME' DEFAULT 'not specified');

 id | ordinality | COUNTRY_NAME | country_id | size_sq_km |  size_other  | premier_name
----+------------+--------------+------------+------------+--------------+---------------
  1 |          1 | Australia    | AU         |            |              | not specified
  5 |          2 | Japan        | JP         |            | 145935 sq_mi | Shinzo Abe
  6 |          3 | Singapore    | SG         |        697 |              | not specified

以下示例展示了多个 text() 节点的连接、列名作为 XPath 过滤器的用法，以及空白、XML 注释和处理指令的处理方式

CREATE TABLE xmlelements AS SELECT
xml $$
  <root>
   <element>  Hello<!-- xyxxz -->2a2<?aaaaa?> <!--x-->  bbb<x>xxx</x>CC  </element>
  </root>
$$ AS data;

SELECT xmltable.*
  FROM xmlelements, XMLTABLE('/root' PASSING data COLUMNS element text);
         element
-------------------------
   Hello2a2   bbbxxxCC

以下示例说明了如何使用 XMLNAMESPACES 子句指定 XML 文档和 XPath 表达式中使用的命名空间列表

WITH xmldata(data) AS (VALUES ('
<example xmlns="http://example.com/myns" xmlns:B="http://example.com/b">
 <item foo="1" B:bar="2"/>
 <item foo="3" B:bar="4"/>
 <item foo="4" B:bar="5"/>
</example>'::xml)
)
SELECT xmltable.*
  FROM XMLTABLE(XMLNAMESPACES('http://example.com/myns' AS x,
                              'http://example.com/b' AS "B"),
             '/x:example/x:item'
                PASSING (SELECT data FROM xmldata)
                COLUMNS foo int PATH '@foo',
                  bar int PATH '@B:bar');
 foo | bar
-----+-----
   1 |   2
   3 |   4
   4 |   5
(3 rows)