添加 OceanBase 物理数据源

更新时间：2023-09-04 16:46:20

配置好数据源是创建数据迁移项目的前提。启动数据迁移前，您必须添加 OceanBase 数据库作为源端或者目标端的数据源。本文为您介绍如何在 OceanBase 迁移服务（OceanBase Migration Service，OMS）中添加 OceanBase 数据源。

前提条件

已获取相关数据库的 IP 地址和端口号。
已存在用于数据迁移的数据库用户。

建议您为数据迁移项目创建一个专属的数据库用户，该用户必须具备相关的数据操作权限。详情请参见创建数据库用户并授权。

操作步骤

登录 OMS 控制台。
在左侧导航栏，单击 数据源管理。
在 数据源管理 页面，单击右上角的 添加数据源。

在 添加数据源 对话框，配置各项参数。数据源类型 默认为 OceanBase，且默认选择 物理数据源。

参数	描述
数据源标识	建议使用中文、数字和字母的组合。名称中不能包含空格，长度不能超过 32 个字符。
地域	从下拉列表中选择数据源所属的地域（即部署 OMS 时配置的 `cm_region` 参数）。注意：仅多地域场景下会显示该参数。请确保数据源与地域的映射关系保持一致，否则可能导致迁移同步性能较差。
租户类型	OceanBase 数据库的租户类型，目前支持 Oracle 和 MySQL 两种类型的租户。
所属 OCP（可选）	从下拉列表中选择已关联的所属 OCP。说明：请自行判断，当前数据源和所选 OCP 是否为被管理关系。设置所属 OCP 是为了 OMS 正常获取 OceanBase 数据库的增量日志，空置本选项会造成增量同步和反向增量选项无法被选择。如果列表中无目标 OCP，请单击添加 OCP，在添加关联 OCP 中配置各项参数。详情请参见关联 OCP。
连接方式	包括手动输入和命令行连接串：手动输入：手动输入 OceanBase 数据库的公网地址和端口。命令行连接串：输入命令行连接串（可选）。
主机 IP	数据库宿主机的 IP。
端口	数据库宿主机 IP 的端口号。
租户名	OceanBase 数据库租户的名称。
集群名	OceanBase 数据库租户所在集群的名称。
数据库用户名	用于数据迁移或数据同步的 OceanBase 数据库用户名称。建议您为数据迁移或同步项目创建单独的数据库用户。
数据库密码	数据库用户的密码。
DB Name（可选）	数据库的名称，仅在租户类型为 MySQL 时指定。
Schema Name（可选）	Schema 的名称，仅在租户类型为 Oracle 时指定。
备注（可选）	数据源的备注信息。

（可选）在 添加数据源 面板，单击 高级选项 右侧的展开，根据业务需求配置相应参数。

创建以 OceanBase 数据源为源端的数据迁移项目时：
- 增量同步需要输入 Configurl、用户名和密码。
- 结构迁移需要输入用户名和密码。
- 无唯一键表迁移需要输入 _OCEANBASE_INNER_DRC_USER 的密码。

创建以 OceanBase 数据源为目标端的数据迁移项目时，反向增量需要输入 Configurl、用户名和密码。

参数	描述
Configurl（可选）	Configurl 主要用于获取 OceanBase 数据库底层服务器的真实地址。如果您已选择所属 OCP，OMS 默认会从 OCP 获取 Configurl，该选项不显示。如果您未选择所属 OCP，可以填写用户名和密码后，单击 Configurl 文本框右侧的在 OceanBase Server 中查询，通过 OceanBase Server 获取 Configurl。如果查询失败，则可以在 OceanBase 数据库 sys 租户下，执行 `show parameters like 'obconfig_url'` 命令，查询的 Value 即 Configurl。
用户名（可选）	部署 OMS 时，config.yaml 文件中的 drc_user。该用户主要用于读取 OceanBase 数据库增量日志，以及获取数据库对象结构，请在 sys 租户下创建该用户。
密码（可选）	drc_user 用户对应的密码。
_OCEANBASE_INNER_DRC_USER 密码（可选）	如果您需要迁移无唯一键表，请输入 `_OCEANBASE_INNER_DRC_USER` 的密码。

单击 测试连接，验证 OMS 和数据源的网络连接，以及用户名和密码的有效性。
测试连接通过后，单击添加。