XMLTable是Oracle将XML按XPath拆分为行和列的工具,核心结构为PASSING传XMLType数据、PATH定位节点、COLUMNS定义列类型与提取规则;需注意大小写敏感、命名空间声明、text()显式取值及空格处理。

XMLTable 是 Oracle 把 XML 拆成普通行和列的“翻译器”——它不解析整个文档,而是按 XPath 定位节点,再把每个匹配节点映射成一行。用对了效率高、写法干净;用错了要么报错 ORA-19279: XPTY0004 - XQuery dynamic type mismatch,要么查不到数据却没提示。
XMLTable 基本结构怎么写?
核心就三块:PASSING 给 XML 数据源,PATH 定位字段位置,COLUMNS 定义输出列类型和提取规则。
SELECT x.id, x.name, x.status
FROM XMLTABLE(
'/root/item' -- 【关键】XPath:从哪开始切出“行”
PASSING XMLTYPE('Alice active ')
COLUMNS
id NUMBER PATH '@id', -- @ 表示取属性
name VARCHAR2(50) PATH 'name/text()',-- text() 显式取文本内容(推荐)
status VARCHAR2(20) PATH 'status' -- 不加 text() 也能取,但遇到空元素会返回 NULL 而非 ''
) x;
-
/root/item是“行级路径”,每匹配一个就生成一行;不是/root或//item(后者虽能用但性能差) - 属性用
@attr,子元素文本建议显式写element/text(),避免隐式转换引发的空值或类型错误 -
PASSING后必须是XMLType,字符串得先套XMLTYPE(...),不能直接传 VARCHAR2
带命名空间的 XML 怎么处理?
Oracle 对命名空间很严格——没声明就查不到,声明错一个字母也查不到。
SELECT x.code, x.amount
FROM XMLTABLE(
XMLNAMESPACES(
'http://example.com/ns' AS "ns",
'http://www.w3.org/2001/XMLSchema-instance' AS "xsi"
),
'/ns:invoice/ns:line' -- 必须用前缀
PASSING XMLTYPE('SKU001100 ')
COLUMNS
code VARCHAR2(20) PATH 'ns:code/text()',
amount NUMBER PATH 'ns:amount/text()'
) x;
-
XMLNAMESPACES(...)必须放在XMLTABLE(后第一个位置,顺序无关但别漏括号 - 所有 XPath 中的元素名都得加前缀(如
ns:code),连根节点也要 —— 即使 XML 里没写前缀,只要声明了默认命名空间,就必须显式引用 - 如果 XML 里用了
xmlns=""清除默认命名空间,那反而不用前缀,但这种情况容易误判,建议先用getClobVal()看原始结构
为什么查出来全是 NULL 或报 ORA-19224?
这是最常卡住人的点:表面语法没错,实际路径根本没命中。- XML 大小写敏感 ——
/Root/Item和/root/item是两回事,别凭记忆写,用getClobVal()看真实标签名 - 空格和换行也算节点 —— 如果 XML 是
,\n Alice\n name/text()取到的是带换行的字符串;要干净值可套normalize-space(name),但需改用XQuery形式(见下条) - 路径返回多值时,
XMLTable默认只取第一个;想展开多值需配合XMLSEQUENCE(已过时)或改用XMLTABLE+ 多层嵌套(更推荐)
进阶:需要处理复杂逻辑(比如过滤、函数、多层嵌套)怎么办?
原生XMLTable 的 PATH 支持有限 XPath 1.0 函数。真要 normalize-space()、substring-after() 或条件判断,得升级为 XQuery 模式:
SELECT x.id, x.clean_name FROM XMLTABLE( 'for $i in /root/item where $i/status = "active" return' PASSING XMLTYPE('
{data($i/@id)} {normalize-space($i/name)} ') COLUMNS id NUMBER PATH 'id', clean_name VARCHAR2(50) PATH 'clean_name' ) x; Bob active
- 这种写法把整个逻辑交给 XQuery 引擎,灵活度高,但调试难 —— 错误信息不直观,建议先在小片段上验证 XQuery 表达式
- 注意大括号
{...}是 XQuery 插值语法,不是 SQL 字符串拼接 - 生产环境慎用复杂 XQuery,尤其嵌套深或 XML 大时,性能可能断崖下跌;优先考虑提前清洗 XML 或拆到应用层处理
真正麻烦的从来不是语法,而是你拿到的 XML 结构是否稳定、有没有隐藏命名空间、text() 前后有没有不可见字符。动手前花 30 秒执行 SELECT xml_col.getClobVal() FROM t WHERE ...,比硬试五种 PATH 写法省两个小时。
Android 基础知识入门 pdf,介绍什么是Android、Android可以完成的功能、Android架构、Android应用程序框架、Android函数库等,从开始安装Android开始,到环境配置,到一步步编写复杂的应用程序,本书将带你了解基础但有内涵的Android入门知识。









