项目开源地址GitHub - mydeworld/AntigravityMigrationStudio · GitHub摘要随着企业去 OOracle入 PGPostgreSQL及国产数据库替代浪潮的深入数据库迁移成为了众多架构师和 DBA 必须面对的硬骨头。传统迁移工具如ora2pg虽功能强大但其繁重的 Perl 依赖环境和纯命令行交互让不少开发者头疼不已而通用图形化工具又缺乏对 Oracle 复杂存储过程和 PL/SQL 语法的智能转换能力。本文将为您深入剖析市场上 Oracle 迁移至 PostgreSQL 的核心痛点并重磅介绍一款零依赖、开箱即用、支持可视化 DDL 预览精修与高性能数据迁移的全新开源工具——Antigravity Migration Studio。---免责与使用声明测试先行异构数据库迁移逻辑复杂强烈建议在正式迁移前务必先在测试库/沙盒环境中进行充分校验与验证。免责声明本工具仅供技术交流与学习参考使用。对于因未经测试直接在生产环境操作、配置不当或语法兼容性等原因造成的任何数据丢失、数据损坏、业务中断或相关损失本工具及开发团队概不承担任何责任。商用须知本开源版本仅供学习与交流使用如需商业用途、商业授权或企业级定制支持请联系开发者团队。---一、背景与行业痛点分析在企业级数据库从 Oracle 向 PostgreSQL及类 PG 架构开源/国产数据库迁移的过程中技术团队往往面临三大“天堑”1. Ora2Pg 痛点环境配置极其痛苦与缺乏可视化“环境地狱”Ora2Pg 依赖 Perl 环境、DBI模块、DBD::Oracle以及 Oracle Instant Client 动态库。在 Windows 或部分 Linux 机器上配置这套环境极易遇到 C 编译器缺失、动态库路径缺失、Perl 模块版本冲突等问题“还没开始迁移环境配了两天”。纯 CLI 交互与盲盒体验所有的转换逻辑通过配置文件驱动命令行输出日志。对于成百上千个包含复杂业务逻辑的 PL/SQL 存储过程、视图和触发器开发者无法在迁移前直观预览转换结果更无法进行在线人工校验与微调修改。2. 通用 GUI 工具如 Navicat、DBeaver痛点缺乏深度语法转换通用图形化客户端主要擅长基础表结构与数据 COPY在面对 Oracle 特有的复杂语法时显得力不从心PL/SQL 存储过程/包/触发器无法自动转换为 PostgreSQL 的PL/pgSQL。内置函数与运算符差异Oracle 的NVL、INSTR、SYS_GUID()、DBMS_OUTPUT等无法自动映射对于 Oracle 中常见的字符串与数值隐式类型转换如字符串数字相加PostgreSQL 会直接抛出类型不匹配报错。Schema 硬编码绑定Oracle DDL 中常常带有硬编码的 Schema 前缀如USER_A.TABLE_NAME直接导入 PostgreSQL 会报schema USER_A does not exist错误。3. 云厂商工具与商业软件痛点成本高与环境受限厂商自研迁移工具通常与特定公有云服务绑定无法在纯本地内网环境、私有云或离线密级网络中灵活部署且授权成本高昂。---## 二、 破局者Antigravity Migration Studio 核心优势针对上述痛点**Antigravity Migration Studio** 重新定义了异构数据库迁移的工作体验。它是一款高性能、全可视化的桌面端数据库迁移工作站专门为 **Oracle / PostgreSQL ➔ PostgreSQL** 迁移量身打造。-----------------------------------------------------------------------------------| Antigravity Migration Studio || || [ 零依赖免安装 ] [ 可视化双栏 DDL 编辑 ] [ Oracle 兼容函数库 运算符重载 ] || 内置引擎双击即用 转换前后实时对比/人工精修 无需修改业务代码自动生成兼容包 || || [ Bulk Copy 批量导入 ] [ Schema 自动清洗 ] [ 可视化失败追踪与排查弹窗 ] || 百万级数据极速写入 自动剥离硬编码 Schema 错误高亮、精准筛选与一键复制报告 |-----------------------------------------------------------------------------------### 核心亮点解读1. **零外部依赖绿色免安装**无需安装 Perl、无需配 Oracle Instant Client、无需编译 C 模块。软件将转换引擎与数据库驱动全套内置解压即用支持一键脚本启动run.bat。2. **可视化 DDL 预览与双栏对比精修Human-in-the-Loop**提供直观的元数据导航树。点击任意对象左侧展示 **Original Oracle SQL**右侧实时显示 **Converted PostgreSQL DDL**。支持在右侧编辑器中直接进行人工修改微调编辑后的 SQL 将直接参与实际迁移。3. **内置 Oracle 兼容函数库与运算符重载**迁移时会在目标 PostgreSQL 库中自动部署常用兼容函数to_number、to_char、instr 等以及重载运算符如 varchar 与 numeric 之间的 、-、 等实现存储过程与业务代码的零成本平滑过户4. ** Schema 自动清洗 (Schema Auto-Cleaning)**自动识别并剥离源数据库中硬编码的 Schema 前缀如 kltewpt.MY_TABLE无缝绑定映射至目标的 PostgreSQL Schema如 public。5. **高性能 Bulk Copy 数据传输引擎**底层基于 PostgreSQL 原生 COPY STDIN (FORMAT CSV) 机制避开逐条 INSERT 的性能瓶颈支持百万级海量数据高速批量并发写入。6. **完善的失败追踪与可视化排查**提供专属 **Migration Failure Details** 弹窗支持按对象名/错误关键字检索定位、错误高亮、明细展示及一键复制错误报告极大缩短排查调试周期。---## 三、 市面主流迁移方案多维对比矩阵| 评估维度 | Ora2Pg | 通用 GUI 工具 (Navicat / DBeaver) | Antigravity Migration Studio || :--- | :--- | :--- | :--- || **部署难度** | 极其复杂 (依赖 Perl/C 编译/Client) | 极简 | **极简 (绿色免安装开箱即用)** || **交互模式** | 纯命令行 (CLI) | 可视化 | **可视化 GUI 双栏对比 在线编辑** || **存储过程 / 函数转换** | 支持 (命令行生成文件不可直观微调) | 不支持 / 仅基础转换 | **智能 PL/SQL ➔ PL/pgSQL 转换 可在线人工精修** || **Oracle 兼容函数/运算符** | 需额外配置脚本 | 无 | **迁移前自动部署兼容函数与重载运算符** || **Schema 硬编码清洗** | 配置文件复杂 | 无 | **自动智能识别并剥离清洗** || **主键重复索引处理** | 需人工干预 | 易报错 | **自动识别并智能剔除冲突索引** || **数据迁移性能** | 高 | 中等 | **极高 (基于原生 Bulk Copy 机制)** || **失败排查与调试** | 查看文本日志 | 弹窗无上下文 | **专属 Failure Details 窗口 错误一键复制** |---## 四、 快速上手与操作指南### 1. 获取代码与软件启动您可以从 GitHub 仓库获取最新项目bashgit clone https://github.com/mydeworld/MigrationPgSql.git根目录提供快捷批处理脚本- 双击运行 **run.bat**一键启动应用。- 若需重新编译运行 **build.bat** 即可自动构建发布版。---### 2. 详细迁移四步法[ 步骤 1: 数据库连接配置 ] ➔ [ 步骤 2: 元数据勾选与 DDL 预览微调 ] ➔ [ 步骤 3: 迁移选项与一键执行 ] ➔ [ 步骤 4: 结果复查与失败排查 ]#### 步骤 1配置数据库连接 (Connections 选项卡)1. **源数据库**选择 Oracle 或 PostgreSQL。填写 Host、PortOracle 默认 1521、Service Name / SID、Username、Password。2. **目标数据库**填写 PostgreSQL 目标库 Host、Port默认 5432、Database Name、Username、Password 及 Target Schema。3. 点击 **Test Connection** 验证两侧连通性成功后点击 **Connect and Load Metadata**。#### 步骤 2元数据勾选与 DDL 在线精修 (Metadata Navigator 选项卡)1. 在左侧树状目录中勾选需要迁移的对象数据表、视图、序列、索引、存储过程/函数、触发器。2. 点击任意对象右侧将显示原始 SQL 与自动转换后的 PostgreSQL DDL。对于复杂的存储过程或视图可在右侧 **Converted PostgreSQL DDL (Editable)** 编辑框中直接手动调整 SQL 语法。#### 步骤 3配置迁移选项与一键执行 (Migration Execution 选项卡)1. 勾选本次执行的迁移模块- Migrate Table Structures / Views结构与视图- Migrate Database Sequences序列- Migrate Non-PK Indexes非主键索引- Migrate Table Data (Bulk Copy)表数据批量导入可选导入前清空目标表- Migrate Procedures, Functions Packages存储过程与函数- Migrate Database Triggers触发器2. 点击 **Start Migration**界面将实时呈现迁移进度条、成功/失败计数器及终端日志。#### 步骤 4迁移结果复查与排查 (Failure Details)1. 迁移完成后根目录下会生成详细日志文件migration.log、failed_objects.log、debug_failed_codes.txt。2. 若存在失败对象点击界面上的 **Show Failures** 按钮打开 **Migration Failure Details** 弹窗方便快速定位错误原因并一键复制错误报告进行修正。---## 五、 高级语法自动转换规则对照| 语法类型 | Oracle 原始语法 | 自动转换后的 PostgreSQL 语法 || :--- | :--- | :--- || **数据类型** | VARCHAR2(N) / NVARCHAR2(N) | varchar(N) || **数据类型** | NUMBER(P,S) / NUMBER | numeric(P,S) / integer / bigint || **数据类型** | CLOB / BLOB | text / bytea || **数据类型** | DATE / TIMESTAMP | timestamp || **数据类型** | SYS_REFCURSOR | refcursor || **空值判断** | NVL(a, b) | COALESCE(a, b) || **位置查找** | INSTR(str, substr) | POSITION(substr IN str) / 内置 instr() || **字符串截取**| SUBSTR(str, pos, len) | SUBSTRING(str FROM pos FOR len) || **唯一标识** | SYS_GUID() | upper(replace(gen_random_uuid()::text, -, )) || **伪表去除** | SELECT ... FROM DUAL | SELECT ... |---## 六、 开源仓库与联系声明- **GitHub 仓库**[GitHub - mydeworld/AntigravityMigrationStudio · GitHub](GitHub - mydeworld/AntigravityMigrationStudio · GitHub)- **开源协议/交流**本工具仅供技术交流、研究与学习参考使用。欢迎提交 Issue 与 Pull Request- ⚠️ **风险提示**数据迁移属于高风险数据库变更操作请务必遵循 **“测试库充分校验 ➔ 生产库执行”** 流程。- **商业合作**如需企业级定制开发、专业技术支持或商业授权请联系开发者团队。