JSON_TABLE是Oracle 12c内联视图构造器，需配合FROM使用，至少指定json_column、COLUMNS子句和以$开头的路径表达式；默认ERROR ON ERROR，空JSON跳过整行；数组须用[*]展开；类型转换严格，推荐VARCHAR2提取后转换；路径大小写敏感。
JSON_TABLE 语法结构和必需参数
oracle 12c 的 json_table 不是函数而是内联视图构造器，必须配合 from 子句使用，且至少要指定 json_column、columns 子句和路径表达式。漏掉 error on error 或 null on error 会导致解析失败时直接报错 ora-40442: json path expression returned no result。
常见写法模板：
SELECT jt.* FROM table_with_json t,
JSON_TABLE(t.json_col, '$'
COLUMNS (
id NUMBER PATH '$.id',
name VARCHAR2(100) PATH '$.name',
active VARCHAR2(5) PATH '$.status'
)
ERROR ON ERROR
) jt;-
PATH表达式必须以$开头，嵌套对象用点号（如$.user.profile.age），数组需用[*]展开 - 不写
ERROR ON ERROR时，默认行为是ERROR ON ERROR，但显式声明更安全 - 如果 JSON 字段为空或 NULL，整行会被跳过——这不是 bug，是默认行为
处理 JSON 数组：用 [*] 展开并注意层级对齐
当源 JSON 是数组（如 [{"a":1},{"a":2}]），必须在 JSON_TABLE 的路径中加 [*]，否则只取第一个元素或报错 ORA-40478: JSON path expression returned more than one value。
错误示例：PATH '$.items.a'（假设 items 是数组）→ 只返回第一个 a 值，且可能触发 ORA-40478；正确写法是 PATH '$.items[*].a'。
- 展开后每一项生成一行，
COLUMNS中所有字段都按同一层级取值，不能混用不同深度的路径 - 若需同时取数组外字段（如元数据）和数组内字段，得用两层
JSON_TABLE嵌套，或先JOIN原表 -
NESTED子句可用于处理嵌套数组，但 Oracle 12c 仅支持单层NESTED，多层需拆解
类型转换陷阱：NUMBER 和 DATE 要小心空字符串和格式
JSON_TABLE 对类型转换很严格。比如 NUMBER PATH '$.count' 遇到 "count": "" 或 "count": "null" 会直接报 ORA-40476: invalid number，而不是返回 NULL。
- 推荐统一用
VARCHAR2先提取，再用TO_NUMBER()或TO_DATE()转换，并配DEFAULT NULL ON CONVERSION ERROR（Oracle 12.2+ 支持；12.1 不支持，只能靠外围CASE判断） - 日期字段如
"created": "2023-05-12T10:30:00Z"，直接DATE PATH '$.created'会失败，必须用TIMESTAMP+ 显式格式化，或先取字符串再TO_TIMESTAMP_TZ -
BOOLEAN类型 JSON（true/false）无法直接映射为 OracleNUMBER或CHAR，得用PATH '$.flag' FORMAT JSON提取原始值，再用CASE WHEN ... = 'true' THEN 1 ELSE 0 END
性能与约束：大 JSON 和索引的影响
每次调用 JSON_TABLE 都会解析整个 JSON 文本，没有缓存机制。如果 json_col 是 CLOB 且体积超过几 MB，查询会明显变慢，甚至触发 PGA 内存溢出。
- 确保
json_col上建了IS JSON检查约束，否则无效 JSON 会在运行时报错，且无法利用 JSON 相关优化 - Oracle 12c 不支持对
JSON_TABLE输出列直接建函数索引；如需加速过滤，应在原表上对提取后的值建普通索引（需物化视图或触发器同步） - 避免在
WHERE中嵌套JSON_TABLE—— 它无法下推谓词，全量解析后才过滤，应尽量把过滤条件提到外层或改用JSON_EXISTS预筛
最易被忽略的是路径表达式的大小写敏感性：JSON 键名 "UserId" 和 "userid" 在路径中必须完全一致，Oracle 不做自动转换，拼错就取不到值，也不会报错，只会返回 NULL。
