项目开源地址：GitHub - mydeworld/AntigravityMigrationStudio · GitHub
摘要：随着企业去 O（Oracle）入 PG（PostgreSQL）及国产数据库替代浪潮的深入，数据库迁移成为了众多架构师和 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 仓库获取最新项目：
```bash
git clone https://github.com/mydeworld/MigrationPgSql.git
```
根目录提供快捷批处理脚本：
- 双击运行 **`run.bat`**：一键启动应用。
- 若需重新编译，运行 **`build.bat`** 即可自动构建发布版。
---
### 2. 详细迁移四步法
```
[ 步骤 1: 数据库连接配置 ] ➔ [ 步骤 2: 元数据勾选与 DDL 预览微调 ] ➔ [ 步骤 3: 迁移选项与一键执行 ] ➔ [ 步骤 4: 结果复查与失败排查 ]
```
#### 步骤 1：配置数据库连接 (Connections 选项卡)
1. **源数据库**：选择 `Oracle` 或 `PostgreSQL`。填写 Host、Port（Oracle 默认 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！
- ⚠️ **风险提示**：数据迁移属于高风险数据库变更操作，请务必遵循 **“测试库充分校验 ➔ 生产库执行”** 流程。
- 🤝 **商业合作**：如需企业级定制开发、专业技术支持或商业授权，请联系开发者团队。
