IvorySQL快速上手：initdb双模式初始化与compatible_mode参数配置实战指南-平芜编程栈

数据库
关系型数据库

【免费下载链接】IvorySQL

Open Source Oracle Compatible PostgreSQL.

项目地址：https://gitcode.com/IvorySQL/IvorySQL

IvorySQL 是一款开源的 Oracle 兼容 PostgreSQL 数据库。本文将带你快速完成 IvorySQL 的initdb 双模式初始化（Oracle 模式 / 原生 PG 模式），并掌握ivorysql.compatible_mode参数的配置方法，帮助新手在一分钟内选对初始化模式、正确切换 SQL 解析器，顺利完成 Oracle 迁移或原生 PostgreSQL 使用场景。🚀

一、IvorySQL 是什么？为什么需要"双模式"？

IvorySQL 基于 PostgreSQL 内核构建，最大亮点是高度兼容 Oracle 语法与生态：支持ROWNUM、NVL、MERGE INTO、DECODE等 Oracle 风格写法，还内置plisql（Oracle 风格 PL 语言）和ivorysql_ora兼容扩展。

为了让两种使用场景互不干扰，IvorySQL 引入了"双模式"设计：

模式	说明	典型场景
Oracle 模式（默认）	加载 Oracle 解析器与兼容扩展，支持 Oracle 方言	从 Oracle 迁移应用
原生 PG 模式	纯 PostgreSQL 行为，不加载 Oracle 解析器	已有 PG 业务、追求稳定

关键结论：集群模式在initdb初始化时就决定了，之后不能在线切换；而连接级的 SQL 解析器则由compatible_mode参数动态控制。

二、initdb 双模式初始化：如何选对 database mode

initdb通过-m / --dbmode参数指定数据库模式，默认值为oracle（默认值定义见 initdb.c，参数解析逻辑见 initdb.c）。

1. 初始化 Oracle 模式集群（推荐迁移用户）

# -m oracle 为默认值，也可省略 initdb -D /data/ivorysql/data -m oracle

Oracle 模式下，initdb 会自动完成以下"重活"：

预载liboracle_parser解析器（通过session_preload_libraries）；
安装plisql过程语言扩展；
安装ivorysql_oraOracle 兼容函数包。

相关初始化流程可参考 initdb.c。

2. 初始化原生 PG 模式集群

initdb -D /data/ivorysql/pgdata -m pg

PG 模式集群不会加载 Oracle 解析器。此时ivorysql.database_mode被固定为pg，后续所有 Oracle 专属 GUC 和 Oracle 解析器都会被禁用，行为与原生 PostgreSQL 保持一致。

3. 附加选项：标识符大小写转换模式

Oracle 模式下还支持-C / --case-conversion-mode初始化选项，配合ivorysql.identifier_case_switch参数控制未加引号标识符的大小写转换（normal/interchange/lowercase），参数定义见 guc_parameters.dat。

💡 选型建议：从 Oracle 迁移选oracle模式（默认即可）；已有纯 PG 业务或追求标准行为选pg模式。两者是集群级决策，建库前想清楚，避免返工。

三、compatible_mode 参数实战：动态切换 SQL 解析器

ivorysql.compatible_mode是连接级（PGC_USERSET）枚举参数，取值pg/oracle，用于在同一个集群内动态切换 SQL 解析器，参数定义见 guc_parameters.dat。

1. 基本用法

-- 切换为 Oracle 解析器 SET ivorysql.compatible_mode TO oracle; -- 切回 PG 解析器 SET ivorysql.compatible_mode TO pg; -- 查看当前解析器模式 SHOW ivorysql.compatible_mode;

切换解析器的核心逻辑在 ivy_guc.c 的assign_compatible_mode中：设为oracle时挂载ora_raw_parser，并刷新search_path。

2. 两个必须知道的限制 ⚠️

限制一：PG 模式集群中禁止启用 Oracle 解析器。在原生 PG 集群里执行SET ivorysql.compatible_mode TO oracle会报错：

ERROR: parameter ivorysql.compatible_mode cannot be changed in native PG mode.

校验逻辑见 ivy_guc.c。

限制二：Oracle 解析器依赖预加载库。Oracle 模式集群切换为oracle解析器时，要求liboracle_parser已预载、IVORYSQL_ORA扩展已安装，否则报liboracle_parser not found!。initdb 已在初始化阶段处理好这些依赖（见 initdb.c 中为安装系统对象临时SET ivorysql.compatible_mode的用法）。

3. database_mode 与 compatible_mode 的关系

参数	作用域	能否运行期修改
`ivorysql.database_mode`	集群级，由 initdb 写入	否（`PGC_INTERNAL`）
`ivorysql.compatible_mode`	会话级	是（受上述限制约束）

简单来说：database_mode决定"这个集群允许做什么"，compatible_mode决定"这条连接现在用什么解析器"。

四、快速上手：三步完成初始化与验证

初始化：按需选择-m oracle（默认）或-m pg：
```
initdb -D /data/ivorysql/data -m oracle
```

启动并连接：

pg_ctl -D /data/ivorysql/data start psql -h /data/ivorysql -p 5432 -d postgres

验证模式：

SHOW ivorysql.database_mode; -- 集群模式 SHOW ivorysql.compatible_mode; -- 当前解析器

验证结果应与初始化时的-m选项一致；Oracle 模式集群中还可执行SET ivorysql.compatible_mode TO oracle;后使用一条NVL()或ROWNUM查询确认 Oracle 语法生效。✅

五、常见问题速查

Q：能在线把 PG 集群变成 Oracle 集群吗？A：不能。database_mode为PGC_INTERNAL，只能在initdb阶段确定（见 ivy_guc.c 的校验逻辑）。
Q：Oracle 模式集群里 PG 语法还能用吗？A：能。compatible_mode取pg时解析器回退为原生 PostgreSQL 解析器，两种写法可按会话混用。
Q：报错Do not use this GUC variable in the current cluster (PG).？A：说明你在 PG 模式集群中使用了 Oracle 专属参数，请换用对应集群或改初始化模式。