Oracle聚集函数必须严格实现ODCIAggregate契约的四个硬编码方法(Initialize、Iterate、Merge、Terminate),签名与调用方式均不可偏差,否则在解析或执行时触发PLS/ORA错误;并行场景下Merge不可或缺,串行可跳过但声明不可省。

因为 Oracle 的 SQL 引擎只认 ODCIAggregate 这一套契约——不实现它,就无法被当作聚集函数调用。
Oracle 聚集函数的执行模型是硬编码的
SQL 引擎在解析 SELECT COUNT(*) FROM t 或 SELECT my_agg(col) FROM t 时,并不会动态猜测你的逻辑怎么跑。它只按固定流程调用四个入口:初始化、迭代、合并、终止。这四个函数名(ODCIAggregateInitialize、ODCIAggregateIterate、ODCIAggregateMerge、ODCIAggregateTerminate)是引擎直接硬调的符号名,必须出现在对象类型的方法定义里,且签名严格匹配。
- 如果少一个方法,
CREATE FUNCTION会报PLS-00323: subprogram or cursor reference is out of scope - 如果参数类型错(比如
value写成IN NUMBER但实际要处理VARCHAR2),迭代阶段直接抛ORA-22370: incorrect usage of an object type - 如果返回值不是
NUMBER(必须是ODCICONST.Success或ODCICONST.Error),整个聚合中途静默失败,结果为空或 NULL
并行执行依赖 ODCIAggregateMerge,但串行下它可被跳过
很多人实测发现:没写 ODCIAggregateMerge,串行查询照样出结果。这不是 bug,是设计使然。Oracle 在串行模式下走单线程流水线,不需要合并分支结果;但只要加了 PARALLEL hint 或表启用了并行 DML,引擎就会拆分数据块、启动多个工作进程,每个进程各自调 Initialize → Iterate,最后必须靠 Merge 把中间状态合起来——此时若该方法缺失或逻辑错误,就会报 ORA-13249: ODCIIndexUtilGetTableNames 类似模糊错误,实际根源就是 Merge 没兜住。
以 CLI 为先的表单构建器,采用 BYOK 理念。通过JSON Schema 生成美观的 HTML 表单,使用您自己的 SMTP 服务器处理提交,存储响应...
- 测试是否真走并行:查
V$PQ_SESSTAT,看Queries Parallelized是否递增 -
Merge的输入参数是另一个同类型实例(v_next IN your_type),不是原始列值,别误当成Iterate复制粘贴 - 若业务确定永不并行,
Merge体里可只写return ODCICONST.Success;,但函数声明不能省
类型体里的方法必须是 STATIC 或 MEMBER,且权限不能受限
对象类型体中,Initialize 必须是 STATIC(因引擎需无实例调用),其余三个必须是 MEMBER(因需操作 self 状态)。常见翻车点:
- 把
Iterate声明成STATIC→ 报PLS-00363: expression 'SELF' cannot be used as an assignment target - 类型没
AUTHID CURRENT_USER,且函数体里调了其他 schema 的表 → 运行时报ORA-00942: table or view does not exist(权限在类型定义时检查,不在调用时) - 类型体编译成功,但
CREATE FUNCTION时提示type does not implement ODCIAggregate→ 实际是类型没FINAL(Oracle 要求该类型不可被继承)
真正容易被忽略的是:ODCIAggregate 不是“接口”而是“约定”,没有 IS 子句声明,也不需要 IMPLEMENTS。它全靠命名、签名、类型体位置这三重隐式绑定——错一个,就断在 SQL 层,不会给你栈追踪,只能靠日志和最小化复现来回推。










