百度360必应搜狗淘宝本站头条
当前位置:网站首页 > 技术资源 > 正文

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

moboyou 2025-03-02 23:36 29 浏览

ra2Pg介绍

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模块。

# root用户下操作

yum install -y perl-ExtUtils-CBuilder perl-ExtUtils-MakeMaker

yum install perl-CPAN

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

perl -MCPAN -e 'install DBI'

perl -MCPAN -e 'install DBD::Pg'

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

# 从Oracle官方下载并安装Oracle Instant Client

rpm -ivh oracle-instantclient19.11-basic-19.11.0.0.0-1.x86_64.rpm

rpm -ivh oracle-instantclient19.11-devel-19.11.0.0.0-1.x86_64.rpm

rpm -ivh oracle-instantclient19.11-jdbc-19.11.0.0.0-1.x86_64.rpm

rpm -ivh oracle-instantclient19.11-sqlplus-19.11.0.0.0-1.x86_64.rpm

# 设置环境变量ORACLE_HOME

export ORACLE_HOME=/usr/lib/oracle/19.11/client64/

# 或者本地已安装有Oracle数据库

ORACLE_HOME如下设置

export ORACLE_HOME=/opt/oracle/product/19c/dbhome_1

export LD_LIBRARY_PATH=$ORACLE_HOME/lib

# 安装DBD:Oracle

perl -MCPAN -e 'install DBD::Oracle'

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

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

# 进到代码目录下,为目标安装路径

perl Makefile.PL PREFIX=

make && make install

# 设置环境变量,查看是否安装成功.为下载的代码路径

export PERL5LIB=/lib

export PATH=$PATH:/usr/local/bin

ora2pg --help

# 创建迁移项目

ora2pg --init_project oramig

创建迁移项目后会在当前目录下生成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设置,指定配置文件时,命令行选项指定的值会覆盖配置文件中的对应值。

Usage: ora2pg [-dhpqv --estimate_cost --dump_as_html] [--option value]


-a | --allow str  : 指定允许导出的对象列表,使用逗号分隔。

-b | --basedir dir: 设置默认的导出目录,用于存储导出SQL文件。

-c | --conf file  : 设置配置文件路径。

-e | --exclude str: 指定导出时排除的对象列表,使用逗号分隔。

-i | --input file : 指定要导入的SQL文件,导入文件时不需要连接到 Oracle 数据库。

-o | --out file   : 设置导出的 SQL 文件的存储路径。默认值为当前目录下的 output.sql 文件。

-p | --plsql      : 启用 PLSQL 代码到 PLPGSQL 代码的转换。

-s | --source DSN : 设置 Oracle DBI 数据源。

-t | --type export: 设置导出类型。该参数将会覆盖配置文件中的导出类型(TYPE)。

-u | --user name  : 设置连接 Oracle 数据库连接的用户名。也可以使用 ORA2PG_USER 环境变量。

-w | --password pwd : 设置连接 Oracle 数据库的用户密码。也可以使用 ORA2PG_PASSWD 环境变量。

--init_project NAME: 初始化典型的Ora2Pg项目,生成目录模板。

--view_as_table str: 将视图导出为表,多个视图使用逗号分隔。

3. 配置Ora2Pg

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

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

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

ORACLE_DSN dbi:Oracle:host=oradb_host.myhost.com;sid=DB_SID;port=1521

或者

ORACLE_DSN dbi:Oracle:DB_SID

第二种方式需要在$
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_DSN dbi:Pg:dbname=mydb;host=localhost;port=5432

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

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

SCHEMA APPS

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

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

TYPE TABLE VIEW

更多更详细的配置项说明,可查看官网:

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

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

ora2pg -t SHOW_VERSION -c config/ora2pg.conf

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

4. 执行迁移脚本

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

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

执行导出脚本,等待迁移完成。结束后在schema和source的子目录下生成对应类型的DDL文件,并在末尾给出导出表数据的命令。

sh export_schema.sh

同时reports目录下也生成html格式的迁移报告。

执行导入脚本之前需要做如下准备:

1. 先在openGauss库中创建数据库,并在该数据库下创建用户,把mydb属主设为该用户。(import_all.sh中使用PostgreSQL特有的createuser和createdb创建用户和数据库)

2. 为了使用openGauss命令行工具gsql,需要将数据库的bin和lib加在操作系统的环境变量PATH和LD_LIBRARY_PATH中。

3. 将import_all.sh里的psql修改为gsql。

4. 当使用普通用户导入数据时,可增加一个执行该脚本的选项,指定用户密码,避免频繁输入密码。

执行导入脚本,表示使用用户testuser登录名为mydb的数据库,ip和端口分别是127.0.0.1和5432,-f选项表示跳过用户和数据库是否需要创建的检查。

sh import_all.sh -d mydb -o testuser –h 127.0.0.1 -p 5432 –f

执行后会交互式提示是否导入各对象结构及数据,如下所示。(其中的-w是手动修改import_all.sh脚本,添加密码选项)

对于表的索引和约束,可选择延迟导入,即在导入数据之后。

登录openGauss数据库查看迁移结果。

Ora2Pg不足

Ora2Pg对PL/SQL和PL/PGSQL的语法转换处理采用正则表达式和文本替换的方式,先天设计不足,很难覆盖所有的语法,目前仅支持部分转换。因此,Ora2Pg可以满足SQL简单的应用迁移,对于复杂的语法,并不能完全保证转换的正确性,需要对生成的SQL语句进行核对,必要时需要人工修正。

更多内容请参考:

https://docs.opengauss.org/zh/docs/3.1.0/docs/BriefTutorial/BriefTutorial.html

相关推荐

iis部署php项目(iis发布php)

1.启动iis服务器最后点击确定就完成了2.打开iis点击进入即可3.创建网站进入添加网站。添加注意事项如图所示!启动、浏览、重启、停止网站这个如图所示。需要说明的是只要修改了配置就必须重启下网站4...

Win10安装Apache和PHP(apache安装php模块)

说明:虽然PHPStudy之类的软件给我们提供了方便的集成环境,但是其使用的是非线程安全的PHP版本(NotThreadSafe,NTS),某些功能不可以使用。所以,我们还需要自己再安装一个Apa...

两个php框架在一个网站上开发好吗

框架就是通过提供一个开发Web程序的基本架构,PHP开发框架把PHPWeb程序开发摆到了流水线上。换句话说,PHP开发框架有助于促进快速软件开发(RAD),这节约了你的时间,有助于创建更为稳定的程序,...

Ubuntu linux 上的 Nginx 和 Php 安装

教程-在UbuntuLinux上安装Nginx1.安装Nginx服务器和所需的包。apt-getupdatebrapt-getinstallnginx2.在Nginx配置文件...

网站开发初级(3) 之 PHP运行环境搭建

这篇文章主要是讲windows下php环境的搭建这里我们用的是phpstudy,作为入门学者足够了,解压安装就能用了,适当配置下基本能应付我们的开发要求下载地址:http://rj.baidu.co...

真实案例:优化用老PHP7.4的网站让其速度提高4倍

我让反应迟钝的PHP应用程序性能提升了4倍,而且我甚至没有改动任何源代码。没有重构,没有重写,只是进行了一系列精心规划的配置调整和部署优化。这篇文章将详细告诉你我是如何做到的。如果你的PHP应用程序运...

mac下快速搭建本地php开发环境(macbook开发php)

本教程主要是告诉大家,怎么快速的在mac下搭建php+mysql服务。一、安装CommandLineTools苹果系统下很多开发工具是基于CommandLineTools,所以安装它是首先。...

php手把手教你做网站(二十)vue+tp6简单案例(demo)

很多时候搭建好了环境,但是不知道怎么入手去开发。下面我们通过简单案例说明如何快速入门开发模块:例1:开发helloworld模块搭建好环境,新建项目以后,进入项目所在文件夹,依次进入src/compo...

Windows安装phpstudy(windows安装docker desktop)

说明:phpstudy是一个PHP+MySQL+Apache的集成环境,可以减少单独部署各个所需软件的麻烦,以及更加方便地切换版本。phpenv、wamp等软件的作用一样。由于环境的不同,安装过程中可...

服务器安装PHP网站的运行环境(php的服务器app)

首先要确认的是你的服务器的系统,Windows、或者linux系统。要想在Windows系统里运行php网站,可以选择iis或者Apache,如果你单独的去安装,可能会花很多时间去配置这个软件直接问题...

折腾群晖NAS:使用群晖web功能搭建个人博客「 小白玩NAS系列」

大家好,今天分享给大家如何利用群晖自带的web功能,来搭建一个属于自己的个人网站或者博客。搭建群晖web环境1、首先进入套件中心,下载webstation,群晖自带的web环境,安装会提示安装PHP...

黑客搭建钓鱼平台,手把手教你如何钓鱼?

跨站脚本攻击XSS:通过HTML注入篡改了网页,插入了恶意的脚本,从而用户浏览网页时,控制用户浏览器的一种攻击那么,我们搭建一个XSS钓鱼平台吧,注意:这个平台仅用于学习和测试,小伙伴们不要动有坏心思...

PHP 环境 搭建教程(php环境搭建apache)

PHP是一种编程语言,很多网站都用PHP语言编写,我们有时候需要测试一个网站,就需要PHP环境才能运行,又要安装Apache、又要安装MySQL……真的非常麻烦。其实我们可以使用PHP集成...

php手把手教你做网站(六)IIS创建站点注意事项

站点名称:随便填写;应用程序池:创建站点的时候会自动生成对应的,默认就好;物理路径:选择站点所在目录;类型:本地一定是http,网上可能会有https;IP地址:默认端口默认,如果是别的端口,网址访问...

分享PHP网站开发过程中的一些经验

现在的网站建设语言有几种,分别是ASP.NET,PHP,JSP这三种最为常见,这三种语言做出来的网站各有各的特点,asp属于最成熟的建站模式,jsp一般使用在大型网站系统上,对于php是目前比较流行的...