如何使用Ora2Pg迁移Oracle数据库到openGauss

Ora2Pg介绍

Ora2Pg是一个将Oracle迁移至PostgreSQL的开源工具，通过连接Oracle数据库，自动扫描并提取其中的对象结构及数据，产生SQL脚本，通过手动或自动的方式将其应用到PostgreSQL。

官方网站：https://ora2pg.darold.net/

Ora2Pg优秀特性

• 支持导出数据库绝大多数对象类型，包括表、视图、序列、索引、外键、约束、函数、存储过程等。
• 提供PL/SQL到PL/PGSQL语法的自动转换，一定程度避免了人工修正。
• 可生成迁移报告，包括迁移难度评估、人天估算。
• 可选对导出数据进行压缩，节约磁盘开销。
• 配置选项丰富，可自定义迁移行为。

Ora2Pg在openGauss的应用

Ora2Pg主要语言是perl，使用Perl DBI模块，通过DBD:Pg连接PostgreSQL目标数据库，openGauss兼容PostgreSQL的通信协议以及绝大部分语法，因此只需作部分命名上的修改，Ora2Pg同样可应用于openGauss。

Ora2Pg使用示例

对于对象结构，Ora2Pg将其DDL语句导出到SQL文件中，对于表数据，则既可以以INSERT或COPY命令导出到文件，也支持直接导入到目标数据库，不需要产生中间SQL文件。

为了完成上述过程，Ora2Pg工具同时支持命令行和一键式脚本的方式完成迁移。命令行方式通过Ora2Pg二进制分布执行各条命令，来完成对应的步骤；一键式脚本通过创建迁移项目，分别得到导出导入脚本以及迁移目录模板，脚本集成了若干Ora2Pg命令以及导入SQL文件所需的psql命令（openGauss为gsql），用户只需要执行两个脚本即可完成迁移。本次主要演示脚本的方式。

1. 依赖安装

Ora2Pg语言为perl，故需安装所需perl模块。

安装DBI、DBD:Pg、DBD:Oracle，Ora2Pg依赖这些软件去连接数据库。

安装DBD:Oracle，需要先安装Oracle Instant Client或者本地已安装Oracle数据库。

2. Ora2Pg安装并创建迁移项目

源码路径：https://github.com/darold/ora2pg

创建迁移项目后会在当前目录下生成oramig目录模板，如下所示。其中主要包含两个脚本export_schema.sh和import_all.sh，后续导出和导入即使用这两个脚本。schema和sources目录存放各对象的DDL语句，区别在于schema存放PL/SQL语法转化为PL/PGSQL后的语句， sources目录存放转化前PL/SQL的语句，data目录存放表数据文件，config目录包含配置文件ora2pg.conf，reports目录存放迁移报告。

至此您已可以使用Ora2Pg命令，以下是使用该命令时允许指定的部分命令行参数，这些参数都可以在ora2pg.conf设置，指定配置文件时，命令行选项指定的值会覆盖配置文件中的对应值。

3. 配置Ora2Pg

ora2pg.conf文件包含所有配置选项，通过配置项可以自定义迁移时的行为。这里简单介绍几个常用的配置项。

ORACLE_HOME：设置环境变量ORACLE_HOME，DBD:Oracle模块使用该变量查找所需的Oracle库。设置方式在依赖安装中已涉及。

ORACLE_DSN：该参数以标准DBI DSN形式设置数据源名称，例如：

或者

第二种方式需要在$ORACLE_HOME/network/admin/tnsnames.ora 文件或者环境变量 TNS_ADMIN 指定目录下的 tnsnames.ora 文件中定义 SID。

ORACLE_USER, ORACLE_PWD：这两个参数用于定义Oracle数据库连接的用户名和密码。请注意，如果可以的话，以Oracle超级管理员身份登录，以避免在数据库扫描时遇到权限问题，以及丢失内容。

PG_DSN：设置目标数据库名称，如下为openGauss示例，连接IP为localhost，端口为5432，名称为mydb的数据库。

PG_USER,PG_PWD：设置目标数据库的用户、密码。请注意，这里使用的用户需要有远程连接openGauss的权限，以及对对应数据库的读写权限，具体是运行Ora2Pg所在的机器和该用户需要在openGauss的远程访问白名单里。

SCHEMA：此参数用于设置要导出的schema。如下，将提取APPS下的对象。

ORA_INITIAL_COMMAND：该参数可用于在连接之后向Oracle发送初始命令。例如，在读取对象前关闭访问限制策略，或设置一些会话参数。

TYPE：设置要导出的对象类型，包括表、视图、序列、索引、外键、约束、函数、存储过程等，默认为TABLE。如下，将导出普通表和视图。

更多更详细的配置项说明，可查看官网：

https://ora2pg.darold.net/documentation.html

连接测试：配置好Oracle数据库的DSN之后，可执行以下命令测试数据库的连接。

以上命令将显示Oracle数据库的版本。

4. 执行迁移脚本

本次演示的配置如下，以system用户连接目标数据库

修改export_schema.sh中导出类型，本次迁移导出表和函数。

后续精彩内容已被小麦苗无情隐藏，请输入验证码解锁本站所有文章

验证码：

请关注本站微信公众号，回复“小麦苗博客”，获取验证码。在微信里搜索“DB宝”或者“www_xmmup_com”或者微信扫描右侧二维码都可以关注本站微信公众号。