介紹

ora2pg可以將 Oracle 或者 MySQL 數(shù)據(jù)庫遷移到 PostgreSQL，應用場景小到 Oracle 數(shù)據(jù)庫的反向工程，大到大型企業(yè)數(shù)據(jù)庫遷移，或者簡單地將一些 Oracle 數(shù)據(jù)復制到 PostgreSQL 數(shù)據(jù)庫。Ora2Pg 由一個 Perl 腳本（ora2pg）以及一個 Perl 模塊（Ora2Pg.pm）組成，唯一需要做的事情就是修改它的配置文件 ora2pg.conf，設置連接 Oracle 數(shù)據(jù)庫的 DSN 和一個可選的模式名稱。完成之后，只需要設置導出的類型：TABLE（包括約束）、VIEW、TABLESPACE、SEQUENCE、INDEXES、TRIGGER、FUNCTION、PROCEDURE、PACKAGE等等。

ora2og是一個將Oracle數(shù)據(jù)庫遷移至openGauss的工具，主要編程語言為perl，通過perl DBI模塊連接Oracle數(shù)據(jù)庫，自動掃描并提取其中的對象結構及數(shù)據(jù)，產(chǎn)生SQL腳本，通過手動或自動的方式應用到openGauss。此外，工具還提供豐富配置項，用戶可以自定義遷移行為。ora2og初始代碼源自ora2pg release v21.1，在原基礎上提供了適配openGauss的相關內容。

特點：

支持導出數(shù)據(jù)庫絕大多數(shù)對象類型，包括表、視圖、序列、索引、外鍵、約束、函數(shù)、存儲過程等。

提供PL/SQL到PL/PGSQL語法的自動轉換，一定程度避免了人工修正。

可生成遷移報告，包括遷移難度評估、人天估算。

可選對導出數(shù)據(jù)進行壓縮，節(jié)約磁盤開銷。

配置選項豐富，可自定義遷移行為。

執(zhí)行遷移

環(huán)境

本篇使用環(huán)境：

Oracle：華為云服務器2核4G + CentoOS 7.6 +Oracle 11.2

openGauss：華為云服務器2核4G + CentoOS 7.6 +openGauss 3.1.0極簡版

兩臺節(jié)點網(wǎng)絡互通

遷移前準備

Ora2og工具既可以安裝在Oracle服務器上，也可以安裝在openGauss服務器上。本篇中將工具部署在Oracle服務器上。

注意，如果安裝在openGauss上時，需要在服務器上安裝Oracle客戶端。下載路徑：

https://www.oracle.com/database/technologies/instant-client/linux-x86-64-downloads.html

軟件安裝

Ora2Pg語言為perl，故需安裝所需perl模塊，版本5.8及以上。

# root用戶下操作
yum install -y perl-ExtUtils-CBuilder perl-ExtUtils-MakeMaker
yum install perl-CPAN

安裝DBI、JSON、DBD:Pg、DBD:Oracle，Ora2Pg依賴這些軟件去連接數(shù)據(jù)庫。

perl -MCPAN -e 'install DBI'
perl -MCPAN -e 'install JSON'
perl-MCPAN-e'installDBD::Pg'

設置root 用戶的環(huán)境變量，可以寫入/etc/profile，然后source生效。

export ORACLE_HOME=/u01/app/oracle/product/11.2.0/
export LD_LIBRARY_PATH=/u01/app/oracle/product/11.2.0/lib

使用perl -MCPAN -e 'install DBD::Oracle'安裝報錯了，換了另一種自己編譯的方式。

[root@oraclehost ora2pg-master]# perl -MCPAN -e shell
......
cpan[1]> get DBD::Oracle
........
Checksum for /root/.cpan/sources/authors/id/Z/ZA/ZARQUON/DBD-Oracle-1.83.tar.gz ok
......
cpan[2]> quit
[root@oraclehost ora2pg-master]# cd /root/.cpan/sources/authors/id/Z/ZA/ZARQUON/
[root@oraclehost ZARQUON]# tar -zxvf DBD-Oracle-1.83.tar.gz
[root@oraclehost ZARQUON]# cd DBD-Oracle-1.83
[root@oraclehost DBD-Oracle-1.83]# perl Makefile.PL
[root@oraclehost DBD-Oracle-1.83]# make && make install

ora2og工具安裝

安裝Ora2Pg 為目標安裝路徑，為下載的代碼路徑。如果服務器上沒有git的話，可以從網(wǎng)站把源碼包下載再解壓。

mkdir -p /opt/software/ora2pg
git clonehttps://toscode.gitee.com/opengauss/openGauss-tools-ora2og.git
# 進到代碼目錄下
perl Makefile.PLPREFIX=
make && makeinstall
# 設置環(huán)境變量，查看是否安裝成功
exportPERL5LIB=/lib
exportPATH=$PATH:/usr/local/bin

需要確保bin路徑下有ora2pg這個文件，否則命令找不到。

執(zhí)行ora2pg --help

創(chuàng)建遷移項目

ora2pg --init_project oramig

創(chuàng)建遷移項目后會在當前目錄下生成oramig目錄模板，如下所示。其中主要包含兩個腳本export_schema.sh和import_all.sh，后續(xù)導出和導入即使用這兩個腳本。schema和sources目錄存放各對象的DDL語句，區(qū)別在于schema存放PL/SQL語法轉化為PL/PGSQL后的語句，sources目錄存放轉化前PL/SQL的語句，data目錄存放表數(shù)據(jù)文件，config目錄包含配置文件ora2pg.conf，reports目錄存放遷移報告。

Oracle建個表，用來做測試數(shù)據(jù)

create table customerchat.test(name char(10));
insert into customerchat.test values('opengauss');
create table customerchat.xxx(name char(20));
insert into customerchat.xxx values('yy');

openGauss側新建數(shù)據(jù)庫mydb和用戶tuser ,遷移時會用到。

mydb=#create database mydb;
mydb=# CREATE USER tuser WITH PASSWORD '自己定義';
mydb=# GRANT ALL PRIVILEGES TO tuser;
mydb=# alter database mydb owner to tuser;

配置ora2pg.conf

拷貝配置文件，注意路徑，后面執(zhí)行sh的時候會找config/ora2pg.conf。

cp/etc/ora2pg/ora2pg.conf.dist/config/ora2pg.conf

ORACLE相關參數(shù)：

ORACLE_HOME /u01/app/oracle/product/11.2.0/
ORACLE_DSN dbihost=oracleIP;sid=orcl;port=1521
ORACLE_USER customerchat // 這里用的oracle普通用戶和密碼
ORACLE_PWD XXXXX
SCHEMAcustomerchat//一般和用戶名一樣

openGauss相關參數(shù)：

PG_DSN dbidbname=mydb;host=localhost;port=5432
PG_USER tuser
PG_PWD 自己定義的密碼

工具自身參數(shù)：

DATA_LIMIT默認是10000，如果oracle服務器內存較小，比如4G以下，可以修改為2500或5000,否則可能會報內存不足。

更多更詳細的配置項說明，可查看官網(wǎng)：

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

測試一下配置：

執(zhí)行ora2pg -t SHOW_VERSION -cconfig/ora2pg.conf會返回連接的Oracle版本號。

測試遷移

修改遷移工具oramig目錄下export_schema.sh中導出類型EXPORT_TYPE和SOURCE_TYPE，本次遷移導出TABLE。

在oramig目錄下執(zhí)行

sh export_schema.sh

執(zhí)行完成后在schema/tables生成table.sql，里面是建表腳本。

reports/目錄下生成的report報告

還是在oramig目錄下執(zhí)行導入

為了使用openGauss命令行工具gsql，需要將數(shù)據(jù)庫的bin和lib加在操作系統(tǒng)的環(huán)境變量PATH和LD_LIBRARY_PATH中。可以直接root用戶執(zhí)行gsql測試下。

3.將import_all.sh里的psql修改為gsql。

執(zhí)行導入腳本，表示使用用戶tuser登錄openGauss中mydb的數(shù)據(jù)庫，ip和端口，-f選項表示跳過用戶和數(shù)據(jù)庫是否需要創(chuàng)建的檢查。

sh import_all.sh -d mydb -o tuser -h openGaussIP -p 5432 -f

執(zhí)行成功。

可以看到表和數(shù)據(jù)都已經(jīng)遷移過來。

Ora2Pg不足

Ora2Pg對PL/SQL和PL/PGSQL的語法轉換處理采用正則表達式和文本替換的方式，先天設計不足，很難覆蓋所有的語法，目前僅支持部分轉換。因此，Ora2Pg可以滿足SQL簡單的應用遷移，對于復雜的語法，并不能完全保證轉換的正確性，需要對生成的SQL語句進行核對，必要時需要人工修正。

FAQ

1.報錯：Path to pg_config? /opt/software/openGauss/bin/pg_config

/opt/software/openGauss/bin/pg_config: error while loading shared libraries: libssl.so.1.1: cannot open shared object file: No such file or directory

環(huán)境自帶的是1.0.2，得升級libssl.so。

[root@oraclehost ~]# openssl version -a
OpenSSL 1.0.2k-fips 26 Jan 2017
yumremoveopenssl

獲取新的版本并安裝

wgethttps://www.openssl.org/source/openssl-1.1.1c.tar.gz
tar -zxvf openssl-1.1.1c.tar.gz
cd openssl-1.1.1c
./config --prefix=/usr/local/openssl #如果此步驟報錯,需要安裝perl以及gcc包
make && make install
ln -s /usr/local/openssl/lib/libssl.so.1.1 /usr/lib64/libssl.so.1.1
ln -s /usr/local/openssl/lib/libcrypto.so.1.1 /usr/lib64/libcrypto.so.1.1
ln -s /usr/local/openssl/bin/openssl /usr/bin/openssl
ln -s /usr/local/openssl/include/openssl /usr/include/openssl
echo "/usr/local/openssl/lib" >> /etc/ld.so.conf
ldconfig -v
sudoyuminstallpostgresql-devel

再重新執(zhí)行perl -MCPAN -e 'install DBD::Pg'

2、perl 報錯 Can’t locate JSON.pm in @INC

解決：

sudo perl -MCPAN -e 'install JSON'

3、如何查看SID？

SQL> select instance_name from V$instance;

4、執(zhí)行ora2pg -t SHOW_VERSION -c ora2pg.conf報錯

FATAL: -1 ... ERROR OCIEnvNlsCreate. Check ORACLE_HOME (Linux) env var or PATH (Windows) and or NLS settings, permissions, etc.
Abortingexport...

Export $ORACLE_HOME了半天，發(fā)現(xiàn)原來是 ora2pg.conf 里面配置的ORACLE_HOME不對

5、執(zhí)行ora2pg -t SHOW_VERSION -c ora2pg.conf報錯

FATAL: 12505 ... ORA-12505: TNS:listener does not currently know of SID given in connect descriptor (DBD ERROR: OCIServerAttach)
Aborting export...

解決辦法SID配置有問題 或者/etc/hosts有問題。參考下面連接解決

https://www.shuzhiduo.com/A/6pdDw0bl5w/

6、執(zhí)行ora2pg -t SHOW_VERSION -c config/ora2pg.conf報錯

install_driver(Oracle) failed: Can't load '/usr/local/lib64/perl5/auto/DBD/Oracle/Oracle.so' for module DBD: libclntsh.so.11.1: cannot open shared object file: No such file or directory at /usr/lib64/perl5/DynaLoader.pm line 190.

解決辦法

export LD_LIBRARY_PATH=$ORACLE_HOME/lib

7、執(zhí)行ora2pg -t SHOW_VERSION -c ora2pg.conf報錯

FATAL: ORA-08178: illegal SERIALIZABLE clause specified for user INTERNAL (DBD ERROR: OCIStmtExecute)

解決辦法：

不要使用sys用戶，使用普通oracle用戶（沒有可新建），然后修改ora2pg.conf中的用戶名和密碼

8、執(zhí)行sh import_all.sh -d mydb -o tuser -hIP-p 5432 -f提示Out of memory ,但是top顯示還有1G多。

解決辦法：

Opened ./config/ora2pg.conf and modfied set DATA_LIMIT 5000 or 2500  solved the issue.

9、報錯：DBD::db do failed: ERROR: permission denied for relationxxx

解決辦法：

需要給openGauss的角色賦權限

mydb=# grant all privileges to tuser;

10、報錯：

DBI connect('dbname=mydb;host=openGaussIP;port=5432','testuser',...) failed: connection to server at "openGaussIP", port 5432 failed: none of the server's SASL authentication mechanisms are supported at /opt/software/ora2pg/lib

解決辦法：

這個錯是openGauss返回的。需要把openGauss的pg_hba.conf & postgres.conf再搞下。

修改data/single_node/postgresql.conf 中password_encryption_type = 1 。

修改pg_hba.conf中

然后重啟openGauss：gs_ctl restart -D /opt/software/openGauss/data/single_node

審核編輯：湯梓紅