如何在Oracle SQL 21c中使用聚合函数处理JSON数据-SQL-PHP中文网

JSON_OBJECTAGG是Oracle 21c的聚合函数，非窗口函数，不支持OVER子句；要求键值均为非空字符串，键重复时保留最后值，键超长会静默截断。

如何在oracle sql 21c中使用聚合函数处理json数据

Oracle 21c 中 `JSON_OBJECTAGG` 的基本用法与限制

Oracle 21c 支持 JSON_OBJECTAGG，但它**不是窗口函数**，不接受 OVER 子句；若强行写，会报错 ORA-30498: invalid use of an analytic function。该函数严格要求两个参数：第一个为键（key），第二个为值（value），且任意一个为 NULL 就直接报错，不会跳过。

常见错误现象包括：

SELECT 中漏写 GROUP BY —— 报 ORA-00937: not a single-group group function
键列含 NULL 值 —— 报 ORA-40478: maximum number of JSON object members (50000) exceeded 或更常见的 ORA-40443: invalid key value in JSON_OBJECTAGG
未显式转换类型，比如用数字列当键 —— Oracle 不自动转字符串，会报 ORA-40467: cannot convert argument to string

实操建议：

键列务必用 TO_CHAR() 或 CAST(... AS VARCHAR2(4000)) 显式转字符串
提前过滤掉键为 NULL 的行：WHERE key_col IS NOT NULL AND value_col IS NOT NULL
若需去重键，靠 GROUP BY + 子查询控制顺序（因重复键保留最后一条，而默认无序），例如加 ROW_NUMBER() OVER (PARTITION BY key_col ORDER BY update_ts DESC) 预处理

`JSON_ARRAYAGG` 在 Oracle 21c 中的空值与重复行为

JSON_ARRAYAGG 默认保留所有非 NULL 值，包括重复项；它**不会自动去重**，也不会报错。但要注意：如果输入全是 NULL，返回的是空数组 []，不是 NULL；如果某行为 ''（空字符串），会被转成 "\u0000" —— 这在前端解析时可能出问题。

性能与兼容性影响：

大数据量下（如百万行聚合），JSON_ARRAYAGG 比 LISTAGG 内存开销更大，容易触发 ORA-04030: out of process memory
Oracle 21c 开始支持 DISTINCT 修饰符：JSON_ARRAYAGG(DISTINCT col)，但不支持 DISTINCT BY(...)（那是 IRIS 的语法，Oracle 不认）
若字段含双引号或反斜杠，JSON_ARRAYAGG 会自动转义，无需手动处理 —— 但这也意味着你不能靠字符串拼接绕过转义逻辑

示例（安全写法）：

SELECT deptno,
       JSON_ARRAYAGG(
         JSON_OBJECT('empno' VALUE empno, 'ename' VALUE ename)
         FORMAT JSON
       ) AS emp_list
FROM emp
WHERE ename IS NOT NULL
GROUP BY deptno;

组合使用 `JSON_OBJECTAGG` 和 `JSON_ARRAYAGG` 构建嵌套结构

Oracle 21c 允许在 JSON_OBJECTAGG 的 value 表达式里嵌套 JSON_ARRAYAGG，这是构建「对象内含数组」结构的唯一标准方式。但必须注意执行顺序：先分组聚合数组，再用外层聚合组装对象 —— 不能反过来。

arcgis-js

提供 ArcGIS Maps SDK for JavaScript 开发辅助，涵盖 2D/3D 地图视图、图层管理、数据可视化、空间分析等功能模块的参考和示例指导。

下载

容易踩的坑：

在同一个 SELECT 中对同一张表既用 JSON_OBJECTAGG 又用 JSON_ARRAYAGG，但没统一 GROUP BY 维度，会导致结果行数不匹配或报错
误以为 JSON_OBJECTAGG(key, JSON_ARRAYAGG(...)) 能自动按 key 分组数组 —— 实际上 JSON_ARRAYAGG 作用域是整个 GROUP BY 分组，不是按 key 动态切片
忘记加 FORMAT JSON —— 若子查询返回的是字符串而非 JSON 类型，外层 JSON_OBJECTAGG 会把它当普通字符串包裹，导致双引号被转义成 \"...

正确结构依赖子查询或 CTE 分层处理，例如：

WITH dept_emps AS (
  SELECT deptno, JSON_ARRAYAGG(
           JSON_OBJECT('empno' VALUE empno, 'job' VALUE job)
         ) AS emps_json
  FROM emp GROUP BY deptno
)
SELECT JSON_OBJECTAGG(
         TO_CHAR(deptno) VALUE emps_json
       ) AS dept_tree
FROM dept_emps;

Oracle 21c JSON 聚合函数对 CLOB 和字符长度的隐式约束

JSON_OBJECTAGG 和 JSON_ARRAYAGG 的返回类型是 CLOB，但它们内部仍受 Oracle 字符长度语义影响。如果键或值表达式结果超过 32767 字节（在 AL32UTF8 字符集下，一个中文常占 3 字节），可能截断或报 ORA-40470: JSON generation error。

关键点：