【数据库迁移避坑指南】Oracle到openGauss迁移实战：ora2og工具部署与典型问题解析

1. 环境准备搭建迁移基础环境数据库迁移的第一步是确保源端和目标端环境就绪。对于Oracle到openGauss的迁移建议采用以下配置方案硬件资源配置建议Oracle服务器至少2核4GB内存实测8GB以上更稳定openGauss服务器与Oracle对等配置建议使用SSD存储网络要求确保双向ping通建议千兆内网环境软件版本兼容性验证Oracle 11g/12c/19c均可支持本文以11.2.0.4为例openGauss 3.1.0及以上版本Perl 5.8推荐5.16操作系统CentOS 7.6/8.2或openEuler 20.03 LTS关键提示生产环境强烈建议先在测试环境验证迁移流程。我曾遇到一个案例因未测试直接迁移导致字符集不兼容最终花费3天时间回退数据。2. 工具部署ora2og安装全流程解析2.1 依赖安装避坑指南Perl模块安装是第一个容易踩坑的环节。执行以下命令前请确保配置好yum源# 基础依赖 yum install -y perl-ExtUtils-CBuilder perl-ExtUtils-MakeMaker gcc make yum install perl-CPAN perl-DBI -y # 关键模块安装建议按顺序 perl -MCPAN -e install JSON perl -MCPAN -e install DBD::Pg常见问题解决方案若遇到DBD::Oracle安装失败需手动编译wget https://cpan.metacpan.org/authors/id/Z/ZA/ZARQUON/DBD-Oracle-1.83.tar.gz tar -zxvf DBD-Oracle-1.83.tar.gz cd DBD-Oracle-1.83 export ORACLE_HOME/u01/app/oracle/product/11.2.0/ perl Makefile.PL make make installOpenSSL版本冲突解决典型错误libssl.so.1.1缺失# 查看当前版本 openssl version -a # 升级步骤 wget https://www.openssl.org/source/openssl-1.1.1c.tar.gz ./config --prefix/usr/local/openssl make make install ln -s /usr/local/openssl/lib/libssl.so.1.1 /usr/lib64/2.2 ora2og本体安装推荐从Gitee获取最新源码mkdir -p /opt/software/ora2pg git clone https://gitee.com/opengauss/openGauss-tools-ora2og.git cd openGauss-tools-ora2og # 指定安装目录建议/usr/local perl Makefile.PL PREFIX/usr/local make make install # 验证安装 export PATH$PATH:/usr/local/bin ora2pg --help3. 迁移配置ora2pg.conf深度优化3.1 关键参数详解配置文件模板位于/usr/local/etc/ora2pg/ora2pg.conf.dist建议复制到项目目录cp /usr/local/etc/ora2pg/ora2pg.conf.dist /opt/ora2pg/config/ora2pg.confOracle连接配置示例ORACLE_HOME /u01/app/oracle/product/11.2.0/ ORACLE_DSN dbi:Oracle:host192.168.1.100;sidorcl;port1521 ORACLE_USER system ORACLE_PWD your_password SCHEMA HRopenGauss连接配置技巧PG_DSN dbi:Pg:dbnamemydb;host192.168.1.101;port5432 PG_USER ogguser PG_PWD openGauss123性能调优参数DATA_LIMIT 5000 # 小内存机器建议调低 DEFINED_PK id # 指定默认主键 PARALLEL_TABLES 4 # 并行表数量3.2 数据类型映射优化在配置文件中添加类型转换规则TYPE ora_number:float4 NUMBER:10,0 TYPE ora_varchar2:text VARCHAR2:*4. 迁移实战分阶段执行策略4.1 初始化迁移项目ora2pg --init_project oramig cd oramig tree生成的目录结构包含config/存放配置文件schema/存储表结构DDLdata/数据导出文件reports/迁移报告4.2 分步执行迁移步骤1仅导出表结构# 修改export_schema.sh EXPORT_TYPETABLE SOURCE_TYPETABLE sh export_schema.sh步骤2数据迁移分批执行# 修改DATA_LIMIT1000防止OOM sh import_all.sh -d mydb -o ogguser -h 192.168.1.101 -p 5432 -f步骤3验证数据一致性-- 在openGauss执行 SELECT count(*) FROM hr.employees; -- 在Oracle执行对比 SELECT count(*) FROM hr.employees;5. 典型问题解决方案5.1 连接类问题问题1OCIEnvNlsCreate错误FATAL: -1 ... ERROR OCIEnvNlsCreate. Check ORACLE_HOME解决方案确认ORACLE_HOME环境变量检查ldconfig -p | grep oci输出添加export LD_LIBRARY_PATH$ORACLE_HOME/lib问题2SASL认证失败DBD::Pg::db do failed: none of the servers SASL authentication mechanisms are supported解决方法 修改openGauss的pg_hba.confhost all all 192.168.1.0/24 md55.2 数据类型转换问题问题CLOB类型转换失败解决方案在配置中添加MODIFY_TYPE CLOB:TEXT对大字段使用分批导出DATA_LIMIT 100 LOB_LIMIT 105.3 性能优化技巧增量迁移对大型表添加WHERE条件分批迁移WHERE employee_id 1000 AND employee_id 2000并行处理nohup sh export_schema.sh log1.log 21 nohup sh import_all.sh log2.log 21 禁用触发器DISABLE_TRIGGERS 16. 高级应用PL/SQL转换策略6.1 存储过程转换在配置中启用PL/SQL转换EXPORT_TYPE PACKAGE PLSQL_PGSQL 1典型转换示例-- Oracle原代码 CREATE OR REPLACE PROCEDURE raise_salary( emp_id IN NUMBER, amount IN NUMBER) IS BEGIN UPDATE employees SET salary salary amount WHERE employee_id emp_id; END; -- 转换后openGauss代码 CREATE OR REPLACE FUNCTION raise_salary( emp_id integer, amount numeric) RETURNS void AS $$ BEGIN UPDATE employees SET salary salary amount WHERE employee_id emp_id; END; $$ LANGUAGE plpgsql;6.2 转换后验证方法使用diff工具对比原始和转换代码执行语法检查gsql -d mydb -f converted_function.sql7. 迁移后优化建议统计信息更新ANALYZE VERBOSE hr.employees;索引重建REINDEX TABLE hr.employees;性能对比测试使用EXPLAIN ANALYZE对比关键查询检查执行计划是否合理应用连接测试修改JDBC连接字符串jdbc:postgresql://192.168.1.101:5432/mydb测试所有关键业务接口