本文主要介绍自建 MySQL 实例和云原生数据库 GaiaDB 实例之间的数据迁移。

前提条件

• 自建 MySQL 数据库版本为 5.1、5.5、5.6、5.7 或 8.0 版本。

  说明

  若源端是其他云平台上的 MySQL 数据库，您还需要确保该数据库已开通公网访问权限。

• 若您的 MySQL 数据库部署在本地，您需要将 DTS 服务器的 IP 地址添加到该数据库远程连接的白名单中，以允许其访问您的数据库。更多信息，请参见 添加 DTS 服务 IP 白名单。
• 已创建存储空间大于自建 MySQL 数据库占用存储空间的目标 GaiaDB 实例。创建方式，请参见 购买集群。

限制说明

应用限制

类型	说明
源端限制	待同步的表需具备主键或唯一约束，且字段具有唯一性，否则可能会导致目标数据库中出现重复数据。 如同步对象为表级别，单次同步任务支持的表数量有限，当超出数量限制，任务提交后会显示请求报错，此时建议您拆分待同步的表，分批配置多个任务，或者配置整库的同步任务。 Binlog 日志，MySQL 需开启 Binlog，并且设置 binlog_format 为 row，binlog_row_image 为 FULL 否则预检查阶段提示报错。 在库表结构同步和全量同步阶段，请勿执行库或表结构变更的 DDL 操作，否则会导致数据同步任务失败。 DTS 要求源端数据库的本地 Binlog 日志至少保留 7 天以上，否则 DTS 可能因无法获取 Binlog 而导致任务失败，极端情况下甚至可能会导致数据不一致或丢失。
其他限制	建议源和目标库版本保持一致，或者从低版本同步到高版本以保障兼容性。如为高版本同步至低版本，可能存在数据库兼容性问题。 执行数据同步前需评估源库和目标库的性能，同时建议业务低峰期执行数据同步。否则全量数据初始化时将占用源库和目标库一定的读写资源，可能会导致数据库的负载上升。
特殊情况	当源库为自建 MySQL 时： 在同步时，如果源库进行主备切换，将会导致同步任务失败。 由于 DTS 的延迟时间是根据同步到目标库最后一条数据的时间戳和当前时间戳对比得出，源库长时间未执行 DML 操作可能导致延迟信息不准确。如果任务显示的延迟时间过大，您可以在源库执行一个 DML 操作来更新延迟信息。

操作限制

迁移过程中请勿进行如下操作，否则会导致迁移任务失败。

• 任务在结构迁移和全量迁移的过程中，不支持 DDL 操作。
• 若仅执行全量数据迁移，请勿向源实例中写入新的数据，否则会导致源和目标数据不一致。为实时保持数据一致性，建议选择结构迁移、全量数据迁移和增量数据迁移。

支持的SQL操作

操作类型	SQL操作语句
DML	INSERT、UPDATE、DELETE
DDL	CREATE DATABASE、CREATE TABLE、CREATE TABLE LIKE、ALTER TABLE、DROP DATABASE、CREATE VIEW、CREATE FUNCTION、CREATE PROCEDURE、ALTER FUNCTION、ALTER PROCEDURE、CREATE TRIGGER、DROP TABLE、TRUNCATE TABLE、RENAME TABLE、DROP INDEX、CREATE INDEX

数据库账号权限要求

数据库	结构迁移	全量迁移	增量迁移
源端	SELECT	SELECT	SELECT,SHOW VIEW,SUPER,REPLICATION SLAVE
目标端	读写权限	读写权限	读写权限

操作步骤

1. 登录 DTS 控制台。
2. 点击 创建数据传输任务 进入 DTS 创建任务页面，详情参见 购买流程。
3. 创建任务成功后自动返回任务列表页面，选择新创建的任务，点击 更多操作—>配置任务。

4. 在配置任务页面，配置源库及目标库信息，本文以 公网 接入方式为例介绍配置流程。

   类别	配置	说明
   任务基本属性	任务名称	DTS 会自动生成一个任务名称，建议配置具有业务意义的名称（无唯一性要求），便于后续识别。
   源端连接设置	主机名/IP	填入源端 MySQL 数据库的访问地址，本示例中填入公网地址。
   	端口	填入源端 MySQL 数据库的服务端口（需开放至公网），默认为 3306。
   	账号	填入源端 MySQL 数据库的账号，权限要求详请参见数据库账号的权限要求。
   	密码	填入该数据库账号对应的密码。
   目标端连接设置	实例 ID	选择目标 GaiaDB 实例 ID。

5. 配置完成后，点击页面下方的 授权白名单进入下一步。

   如果您主动为 MySQL 关联了自定义的 VPC 安全组规则，则需要您手动添加对应地区 DTS 服务的 IP 地址，以允许来自 DTS 服务器的访问，操作步骤请参见 为您的 VPC 安全组添加 DTS 网段的放行规则。

   警告：

   DTS 自动添加或您手动添加 DTS 服务的 IP 地址段可能会存在安全风险，一旦使用本产品代表您已理解和确认其中可能存在的安全风险，并且需要您做好基本的安全防护，包括但不限于加强账号密码强度防范、限制各网段开放的端口号、内部各 API 使用鉴权方式通信、定期检查并限制不需要的网段等等。

6. 配置任务对象映射。

   配置	说明
   迁移类型	根据需求及各引擎对迁移类型的支持情况，选择迁移类型。
   限制传输速度	根据实际情况，选择是否对全量迁移和增量同步任务进行更细粒度的限流策略设置（设置 每秒迁移的行数 和 每秒迁移的数据量），以缓解目标库压力。详情参见：迁移限速。
   同步 Online DDL	指定是否同步由 gh-ost, pt-osc、DMS 工具执行的表结构变更操作。详情参见：同步 Online DDL。
   传输对象	整个实例：将源端除系统库外的所有数据迁移到目标端，不迁移的系统库为：mysql、sys、information_schema、performance_schema。手动选择：选择此选项时，在页面左侧选择需要迁移的库表，库表信息将会被自动添加到页面右侧。模式匹配：详情参见：模式匹配。

7. 上述配置完成后，点击页面下方的 保存并预检查。

   说明

   • 在迁移任务正式启动之前，会先进行预检查。只有预检查通过后，才能成功启动迁移任务。
   • 如果预检查失败，请查看失败检查项的提示，并根据提示修复后重新进行预检查。

   • 如果预检查产生警告：

     • 对于不可以忽略的检查项，请查看失败检查项的提示，并根据提示修复后重新进行预检查。
     • 对于可以忽略无需修复的检查项，您可以点击 强制通过，在弹出的窗口中勾选风险确认信息并点击 确定，跳过告警检查项重新进行预检查。如果选择屏蔽告警检查项，可能会导致数据不一致等问题，给业务带来风险。

8. 前置校验提示校验成功后，点击 立即开启任务。
9. 迁移任务正式开始，您可以在任务列表页面查看具体进度。

后续操作（可选）

数据校验

详情参见 配置数据校验。

业务切换

详情参见 业务切换流程。