新建 OceanBase 数据库 MySQL 租户至 AnalyticDB MySQL 的数据同步项目 - 云数据库 OceanBase

本文为您介绍如何新建 OceanBase 数据库至云原生数据仓库 AnalyticDB MySQL 版（简称 ADB）的数据同步项目。

背景信息

ADB 的基本介绍请参见基础数据类型。
ADB 的建表、分区表和分布表的详情请参见 CREATE TABLE。

数据类型映射

OceanBase 数据库 MySQL 租户数据类型	AnalyticDB MySQL（3.0 版本）数据类型
BIGINT	BIGINT
BINARY	VARBINARY
BIT	VARBINARY
BLOB	VARBINARY
CHAR	VARCHAR
DATE	DATE
DATETIME	DATETIME
DECIMAL	DECIMAL(p,s) p: 1~1000 s<=p
DOUBLE	DOUBLE
ENUM	VARCHAR
FLOAT	FLOAT
INT	INT
INTEGER	INT
LONGBLOB	VARBINARY
LONGTEXT	VARCHAR
MEDIUMBLOB	VARBINARY
MEDIUMTEXT	VARCHAR
NUMERIC	DECIMAL
SET	VARCHAR
SMALLINT	SMALLINT
TEXT	VARCHAR
TIME	TIME
TIMESTAMP	TIMESTAMP
TINYBLOB	VARBINARY
TINYINT	TINYINT
TINYTEXT	VARCHAR
VARBINARY	VARBINARY
VARCHAR	VARCHAR
YEAR	BIGINT

操作步骤

新建同步项目。
1. 登录 OceanBase 控制台。
2. 在左侧导航栏，单击 数据传输 > 数据同步。
3. 在 数据同步 页面，单击右上角的 新建同步项目。

在 选择源和目标 页面，配置各项参数。

参数	描述
同步项目名称	支持中文、数字和字母的组合，不得超过 64 个字符。
传输实例	从下拉列表中选择已经购买的传输实例。如果您未购买，请单击右侧的购买进行操作。详情请参见购买传输实例。
源节点	如果您已创建 OceanBase 数据源，请从下拉列表中进行选择。如果未创建，请单击下拉列表中的添加数据源，在右侧对话框进行添加。参数详情请参见创建数据源（OceanBase）。
目标节点	如果您已创建 ADB 数据源，请从下拉列表中进行选择。如果未创建，请单击下拉列表中的添加数据源，在右侧对话框进行添加。参数详情请参见创建数据源（ADB）。

单击 下一步。
在 选择同步类型和配置 页面，勾选当前数据同步项目的 同步类型和配置。
同步类型和配置 包括 结构同步、全量同步 和 增量同步。增量同步 包括 数据变更 DML 和 同步 DDL。
- 数据变更 DML 包括 Insert、Delete 和 Update，默认全部勾选。
- 同步 DDL 支持 ADD COLUMN 和 MODIFY COLUMN。

在 选择同步类型和配置 页面，选择同步范围。

在选择区域左侧选中需要同步的对象，单击 >，将其添加至右侧列表中。

选择同步对象后，OMS 支持对目标端对象进行重命名、设置行过滤、移除单个对象或全部对象等操作。

操作	步骤
重命名	OMS 支持重命名库名和表名。在选择区域的右侧列表中，鼠标悬停至目标对象。单击显示的重命名。输入修改后的名称，单击确定。
设置	OMS 支持 `WHERE` 条件实现行过滤、选择需要同步的列，以及设置主键列、分布键和分区键等。在选择区域的右侧列表中，鼠标悬停至目标对象。单击显示的设置。在设置对话框中，您可以进行以下操作：输入标准的 SQL 语句中的 `WHERE` 子句，来配置行过滤。只有满足 `WHERE` 条件的数据才会被同步至目标数据源，以实现数据的行过滤。如果语句中包含 SQL 保留关键字，请添加转义符（`）。重新设置主键列。默认展示当前表的主键列（可以是多列）。您可以删除现有的主键列，通过单击下拉或搜索的方式，重新设置主键列（支持多列）。设置分布键。设置分区键。如果您开启设置分区键，则需要在分区键表达式文本框中输入表达式。例如，`PARTITION BY VALUE('id')`。设置生命周期。单击确定。您还可以在查看列区域，查看同步对象的列信息。
移除/全部移除	OMS 支持移除单个或全部同步对象。移除单个同步对象在选择区域的右侧列表中，鼠标悬停至目标对象，单击显示的移除，即可移除该同步对象。移除全部同步对象在选择区域的右侧列表中，单击右上角的全部移除。在对话框中，单击确定，即可移除全部同步对象。

操作

步骤

重命名

OMS 支持重命名库名和表名。

在选择区域的右侧列表中，鼠标悬停至目标对象。
单击显示的 重命名。
输入修改后的名称，单击确定。

设置

OMS 支持 WHERE 条件实现行过滤、选择需要同步的列，以及设置主键列、分布键和分区键等。

在选择区域的右侧列表中，鼠标悬停至目标对象。
单击显示的设置。
在设置对话框中，您可以进行以下操作：
- 输入标准的 SQL 语句中的 WHERE 子句，来配置行过滤。
  只有满足 WHERE 条件的数据才会被同步至目标数据源，以实现数据的行过滤。如果语句中包含 SQL 保留关键字，请添加转义符（`）。
- 重新设置主键列。
  默认展示当前表的主键列（可以是多列）。您可以删除现有的主键列，通过单击下拉或搜索的方式，重新设置主键列（支持多列）。
- 设置分布键。
- 设置分区键。如果您开启设置分区键，则需要在 分区键表达式 文本框中输入表达式。例如，PARTITION BY VALUE('id')。
- 设置生命周期。
单击确定。
您还可以在 查看列 区域，查看同步对象的列信息。

移除/全部移除

OMS 支持移除单个或全部同步对象。

移除单个同步对象
在选择区域的右侧列表中，鼠标悬停至目标对象，单击显示的移除，即可移除该同步对象。
移除全部同步对象
在选择区域的右侧列表中，单击右上角的 全部移除。在对话框中，单击确定，即可移除全部同步对象。

单击 下一步。
在 同步选项 页面，配置 增量同步起始位点。
- 如果设置同步类型和配置时已勾选 全量同步，此处默认为项目启动时间，不支持修改。
- 如果设置同步类型和配置时未勾选 全量同步，请在此处指定同步某个时间节点之后的数据，默认为当前系统时间。您可以选择时间节点，也可以直接输入时间戳。
  注意
  仅支持选择当前时间，或当前时间之前的时间点。
  该位点与当前归档日志的保留时间密切相关。如果无特殊要求，可以从当前位点开始启动。
单击 预检查。
如果预检查报错，请排查并处理问题后，重新执行预检查，直至预检查成功。
单击 启动任务，启动该项目的增量同步等各项任务。
如果您暂时无需启动任务，请单击保存，跳转至数据同步项目的详情页面，您可以根据需要手动启动数据同步项目。如果您需要查看详情，请参见查看数据同步项目的详情。

如果中途接入数据的过程出错（通常由于网络不通或进程启动过慢导致），您可以进入任务的详情页面，单击右上角的恢复（此处为了延时，使用暂停再恢复）。