原文来源：https://tidb.net/blog/23711dfd

作者：杨漆 16 年关系型数据库管理，从oracle 9i 、10g、11g、12c 到 Mysql5.5、5.6、5.7、8.0 到 TiDB 获得 3 个 OCP、2 个 OCM；运维路上不平坦，跌过不少坑、熬过许多夜。把工作笔记整理出来分享给大伙儿，希望帮到大家少走弯路、少熬夜。

Best Practice for Data migration from Oracleto Tidb

为何要选择 TiDB ?

随着业务的高速发展、数据的爆发式增长，很多使用关系型数据库的公司为保障业务的有效进行不得不面临一轮数据库的垂直拆分和水平拆分。但拆分后对代码的侵入性较大，后续的不断扩容让 DBA 的管理成本上升（时间成本、运维成本、管理复杂度等等）。所以急需一种既能支持关系型数据库 RDBMS 和非关系型数据库 NoSQL 分布式的存储计算引擎。

市场上有没有这种兼二者之长的 Database ?

有！TiDB 分布式数据库结合了传统的 RDBMS 和 NoSQL 的最佳特性。首先，高度兼容 MySQL 协议，大多数情况代码可以直接迁移到 TiDB 分布式数据库，已分库分表的实例可以在 TiDB 中进行聚合；同时，TiDB 分布式数据库支持水平弹性扩展，通过简单地增加新节点即可实现 TiDB 分布式数据库的水平扩展，按需扩展计算节点或存储节点，轻松应对高并发、海量数据场景。

下面介绍怎样将 Oracle 中的数据同步到 TiDB 分布式数据库：

OGG 是一个综合软件包，用于在异构环境中进行实时数据集成和复制。高可用性解决方案、实时数据集成、事务更改数据捕获、数据复制、转换、操作和分析企业间的系统验证。三个步骤：

1、DDL 的转换（使用 Navicat 或其它工具），注意字段类型和一些不兼容的转换 2、全量数据迁移（使用 ogg Initial Load）3、增量数据迁移（使用 ogg）增量同步需要在初始化同步之前，先开启日志抽取。由于异构平台，无法基于统一时间点完成数据初始导入操作，所以在完成初始化导入操作之后需要完整应用开始 initial load 同步之后的所有 log，此时会存在重复执行的问题，OGG 中通过 handlecolisions 参数处理冲突的场景，保证最终数据的一致性（根据主键或唯一键进行重复的操作可以保证最终数据一致，在缺少主键的场景可能会导致数据重复）。源端 Oracle 要求• 开启归档模式• 开启 Force logging• 设置 ENABLE_GOLDENGATE_REPLICATION 参数为 true (11.2.0.4)• 开启最小补全日志（根据同步数据范围选择）o 表级别 o Schema 级别 o 数据库级• 用户权限 o DBA 角色目标端 TiDB 分布式数据库要求• set tidb_constraint_check_in_place = 1;该参数将 TiDB 分布式数据库中乐观锁模式下的主键冲突检查由 commit 时检查提升为 insert 时检查，在遇到主键冲突时可配置为忽略冲突，否则在遇到主键冲突时无法忽略，复制进程会 abend。仅需在 OGG 复制进程 session 级别设置，通过配置在复制进程参数中实现，无需全局修改。• lower-case-table-names = 1OGG 复制进程需要该参数设置为 1，tidb 中修改此参数并未产生实际效果变化，仅为实现兼容。OGG 同步要求：DDL 建表语句需提前转换，并在目标端执行。

增量抽取：

OGG Architecture

1. OGG 一定要使用以上版本（经过原厂迁移实践 Product DB : Oracle 11G）

2. 要注意表名的大小写（tidb 中的表名大小写 与 ogg 中一定要严格统一，否则会报错）

A.OGG 安装 - Oracle 端

解压安装包：unzip V975837-01.zip

静默安装方式：vi./fbo_ggs_Linux_x64_shiphome/Disk1/response/oggcore.rsp

修改以下几处关键点就好：

oracle.install.responseFileVersion=/oracle/install/rspfmt_ogginstall_response_schema_v12_1_2## 默认无需修改 INSTALL_OPTION=ORA11g## 此处为 Oracle 数据库版本，本文档使用 11.2.0.4，此处填写 ORA11G，如果是 12c 版本则填写 ORA12cSOFTWARE_LOCATION=/home/oracle/ogg12.3## 此处为安装路径START_MANAGER=false## 安装完成不启动 mgr 进程，设为 false

安装 ogg：$./fbo_ggs_Linux_x64_shiphome/Disk1/runInstaller -silent -responseFile/home/oracle/oggsoft/fbo_ggs_Linux_x64_shiphome/Disk1/response/oggcore.rsp# 此处 response 文件不支持相对路径

Vi ~/ .bash_profile<br>exportLD_LIBRARY_PATH=$ORACLE_HOME/lib

ogg 初始化 (创建目录)：

$ ./ggsci

GGSCI ( hostname ) 1> create subdirs

B.OGG 安装 - TiDB 分布式数据库端

解压安装包： $ unzip V978711-01.zip

$tar xvf ./ggs_Linux_x64_MySQL_64bit.tar -C /home/tidb/ogg12.3

ogg 初始化 (创建目录)：

$ ./ggsci

GGSCI ( hostname ) 1> create subdirs

C.TiDB 分布式数据库端数据库环境准备

(1) 设置 lower-case-table-names 参数为 1$grep lower-case-table-names tidb.toml<br>lower-case-table-names = 1

(2) 检查参数是否正确

(3) 创建用于同步的用户并赋权create user ‘tidb’ identified by ‘tidb’;

GRANT ALL PRIVILEGES ON scott.* to oggadmin ;

(4) 创建对应表结构

D.Oracle 端数据库环境准备

(1). 开启归档模式：

shutdown immediate;<br>startup mount;<br>alter database archivelog;<br>alter database open;

若 DB 已为归档模式以上步骤省略

(2). 开启数据级别的增量日志

ALTER DATABASE FORCE LOGGING;开启强同步，会记录所有的事务日志以及数据导入的日志，即使用户设置了 nolog 也会记录。ALTER DATABASE ADD SUPPLEMENTAL LOG DATA;<br>ALTER SYSTEM SWITCH LOGFILE;<br>selectlog_mode,supplemental_log_data_min,force_logging from v$database;

查询是否开启增量日志

(3) 数据库中允许启动 OGG

alter system set enable_goldengate_replication=true;

(4) 创建 goldengate 用户，并赋予相关权限

SQL> create tablespace goldengate datafile’/data/goldengate.dbf’ size 10G autoextend on next 1G maxsize unlimited;

SQL> create user goldengate identified by goldengate default tablespace goldengate;

SQL> grant dba to goldengate;

(5) ggsci 中创建免密登录秘钥

./ggsci<br>create subdirs<br>add credentialstore<br>alter credentialstore add user goldengate,passwordgoldengate

(6) 直接执行下面命令即可在 ogg 中登录到 goldengate 用户

dblogin useridalias goldengate

(7) 开启 schema 级别的附加日志，能够确保 schema 下新表的附加日志也会被自动捕获。

若数据库版本低于 11.2.0.2，则需要打 Oracle Patch 13794550 若以前的 oracle 数据库版本没有打上面的补丁，开启 schema 级别附加日志会报如下错误：ERROR OGG-06522 Cannot verify existence of table function that is required to ADD schema level supplemental logging, failed.

a. GGSCI 登录有两种方式

dblogin userid goldengate, password goldengatedblogin useridalias goldengate

b. 为指定 schema 开启日志捕获

ADD SCHEMATRANDATA schema ALLCOLS

c. 当没有启动 schema 级别的附加日志时，可以使用基于表级别的附加日志

GGSCI 登录: dblogin userid goldengate, password goldengate2) 为指定 schema 开启日志捕获: ADD TRANDATA schema.tablename NOKEY

E. MGR 进程配置

Manager 进程是 OGG 的控制进程，用于管理 Extract、Pump、Replicat 等进程，在 Extract、Pump、Replicat 进程启动之前，Manager 进程必须先要在源端和目标端启动。

F. Extract 进程配置

Extract 进程运行在数据库源端上，它是 OGG 的捕获进程，可以配置 Extract 进程来初始数据装载和同步变化捕获。

G. Pump 进程配置

Pump 进程是配置在源端辅助 Extract 进程，Pump 进程将 Extract 进程写好的本地 Trail 文件通过网络发送到目标端的 Trail 文件中。

H. 配置应用端

I. Replicat 进程配置

Replicat 进程是运行在目标端系统的一个进程，负责读取 Extract 进程提取到的数据（变更的事务或 DDL 变化）并应用到目标数据库。

J. 配置全量抽取

K. 配置全量应用

进程启动顺序：

测试性能数据：四个分组，每组 25 个线程并发度控制。

单表 30 列时，每秒可加载 10 万行数据。单表 200 列时，每秒可加载 2 万行数据。OGG 运行中常见故障：

OGG-01201 Error reported by MGR : Access denied 原因：This is due to a new security restriction in GoldenGate 12.2. In order to allow access from a remote system the ACCESSRULE parameter must be put into the manager parameter file on the target in order to allow access from the source.处理方法：需要在源端 mgr 增加允许访问目标端 ip 的规则(1) 编辑 mgr 参数文件 edit params mgr

(2) 增加以下内容：

ACCESSRULE, PROG *, IPADDR *, ALLOW

replicat 端报 invalid time format 问题原因：之前把 Oracle 的 date 类型改为了 TIDB timestmap 类型，但是 Oracle 里面部分时间类型数据超过了 TIDB timestamp 的范围。（TIDB 范围为 1970-01-01 00:00:01.000000 到 2038-01-19 03:14:07.999999，Oracle 部分时间数据超过 2038 年，应该是原先遗留的测试数据）。处理方法：将 TIDB 的 timestamp 改为支持更大的 datetime 类型；同时在 OGG replicat 端增加异常数据不 abended 而是记录 discard 的方式，具体参数为：REPERROR (default,discard)，防止 OGG 因为异常数据终止。extract 报 ORA-01801: date format is too long for internal buffer 问题原因：Oracle 端有时间类型数据通过 OCI 接口入库时，Oracle 不做时间校验，但是查询的时候就会校验时间格式，正常 Oracle select * 都会报错，属于 Oracle 端数据问题。处理方法：用 to_char（date,’yyyy-mm-dd hh24:mi:ss’）处理错误日期后，Oracle 可以正常查出来，但是显示的时间为 ‘0000-00-00 00:00:00’ 的样式，可以通过类似以下的语句查出错误数据，在源端处理掉错误数据：（1）备份错误数据 create table t_bak as select * from t whereto_char(date1,’yyyy-mm-dd hh24:mi:ss’)= ‘0000-00-00 00:00:00’;

（2）删除原表错误数据:

delete from t where id in (select id from t_bak);

commit;