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 install- OpenSSL版本冲突解决(典型错误:
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:host=192.168.1.100;sid=orcl;port=1521 ORACLE_USER system ORACLE_PWD your_password SCHEMA HRopenGauss连接配置技巧:
PG_DSN dbi:Pg:dbname=mydb;host=192.168.1.101;port=5432 PG_USER ogguser PG_PWD openGauss@123性能调优参数:
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_TYPE="TABLE" SOURCE_TYPE="TABLE" sh export_schema.sh步骤2:数据迁移(分批执行)
# 修改DATA_LIMIT=1000防止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 连接类问题
问题1:OCIEnvNlsCreate错误
FATAL: -1 ... ERROR OCIEnvNlsCreate. Check ORACLE_HOME解决方案:
- 确认
ORACLE_HOME环境变量 - 检查
ldconfig -p | grep oci输出 - 添加
export LD_LIBRARY_PATH=$ORACLE_HOME/lib
问题2:SASL认证失败
DBD::Pg::db do failed: none of the server's SASL authentication mechanisms are supported解决方法: 修改openGauss的pg_hba.conf:
host 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 2>&1 & nohup sh import_all.sh > log2.log 2>&1 &禁用触发器:
DISABLE_TRIGGERS 1
6. 高级应用: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- 测试所有关键业务接口