xmltable是oracle解析xml最稳定可控的方式，需指定passing和columns子句，支持命名空间声明、嵌套解析及性能优化，错误多源于xpath不准、命名空间遗漏或结构误用。
xmltable 是 oracle 解析 xml 最稳定、最可控的方式，比 extract 和 xmlparse 更适合结构化提取，尤其在字段多、层级深、需类型转换时几乎不可替代。
XMLTABLE 基本用法：必须指定 PASSING 和 COLUMNS
XMLTABLE 不是函数，而是一个表函数（table function），必须配合 PASSING 子句传入 XML 数据，并用 COLUMNS 明确声明输出列名、类型和 XPath 路径。漏掉任一子句都会报错，比如 ORA-19279: XPTY0004 - The context item is not a node。
常见错误现象：
- 只写
XMLTABLE('/root')，没加PASSING→ 报错“no XML data passed” -
COLUMNS中用FOR ORDINALITY但没放在第一列 → 位置错乱导致序号错位 - XPath 写成
/root/item/text()（带text()）→ 返回空值，应改用/root/item并靠PATH隐式取文本
正确示例：
SELECT x.name, x.age, x.city
FROM your_table t,
XMLTABLE('/people/person'
PASSING XMLTYPE(t.xml_data)
COLUMNS
name VARCHAR2(50) PATH 'name',
age NUMBER PATH 'age',
city VARCHAR2(30) PATH 'address/city'
) x;
处理命名空间：NAMESPACE 必须显式声明
含命名空间的 XML（如 <person xmlns:ns="http://example.com"></person>）不声明 XMLNAMESPACES，XPath 就完全匹配失败，且不会报错，只会返回空结果 —— 这是最容易被忽略的坑。
使用要点：
-
XMLNAMESPACES必须写在XMLTABLE的PASSING之前，不能放COLUMNS里 - 前缀名（如
ns）要和 XML 中一致；默认命名空间用DEFAULT声明 - 路径中必须带上前缀，如
'ns:name'，否则视为无命名空间节点
示例：
SELECT x.name
FROM your_table t,
XMLTABLE(XMLNAMESPACES('http://example.com' AS "ns"),
'/ns:people/ns:person'
PASSING XMLTYPE(t.xml_data)
COLUMNS name VARCHAR2(50) PATH 'ns:name') x;
嵌套 XMLTABLE：逐层展开多级结构
当 XML 有父子多层（如 <order><item><sku>A</sku><qty>2</qty></item><item>...</item></order>），单层 XMLTABLE 只能拿到 <item></item> 列表，无法直接关联到外层 <order></order> 字段。这时要用嵌套写法。
关键逻辑：
- 外层 XMLTABLE 提取主记录（如 order_id、date），同时把每个
<item></item>子树用XMLTYPE作为列传出 - 内层 XMLTABLE 的
PASSING接收该子树，再提取 sku、qty 等细节 - 两层之间用逗号连接，不是 JOIN，语法上是“from 表, XMLTABLE, XMLTABLE”
示例（简化）：
SELECT o.order_id, i.sku, i.qty
FROM orders o,
XMLTABLE('/order'
PASSING XMLTYPE(o.xml_col)
COLUMNS
order_id VARCHAR2(20) PATH '@id',
items XMLTYPE PATH 'item'
) oxt,
XMLTABLE('/item'
PASSING oxt.items
COLUMNS
sku VARCHAR2(20) PATH 'sku',
qty NUMBER PATH 'qty'
) i;
性能与兼容性：别在 WHERE 中对 XMLTYPE 列直接用 LIKE
XMLTABLE 本身不慢，但若在外部 SQL 的 WHERE 子句中对原始 XML 列（如 t.xml_col）做 LIKE '%<status>done</status>'，会强制全表扫描 + 字符串匹配，彻底绕过 XML 索引。而 XMLTABLE 配合 XMLIndex 才能真正加速。
实操建议：
- 高频查询字段（如 status、code）应在
COLUMNS中定义为虚拟列并建索引：ALTER TABLE t ADD (status_gen AS (XMLTABLE(...).status)) - Oracle 11g+ 支持
CREATE INDEX idx_xml ON t (xml_col) INDEXTYPE IS XDB.XMLINDEX，但仅对 XPath 查询生效，对字符串模糊查无效 - 如果 XML 很大（>1MB）且只查少量字段，优先用
XMLTABLE拆出关键列，再走普通 B-tree 索引，比全 XML 索引更轻量
真实项目里，XMLTABLE 的难点不在语法，而在 XPath 是否精准命中目标节点、命名空间是否漏配、以及把 XML 结构误当成平面数据去 JOIN —— 这三处出错，查半天也看不出哪条语句有问题。
