概览

本文介绍一键迁移从RDS至GaiaDB的迁移方案，并且介绍如何配置白名单、账号等信息方便您在迁移后能尽快使用。

重要：本文中含有需要迁移中您注意的提示信息，忽略该信息可能对迁移效率造成影响，请务必仔细阅读。

迁移方案

整个升级过程中将包含以下步骤：

步骤一：从RDS迁移：在GaiaDB购买页面，选择创建方式为从RDS迁移，并指定源RDS版本及实例ID，以创建一个目标GaiaDB集群。

说明：可迁移的实例必须通过迁移评估检查。

步骤二：创建账号和配置白名单：当前一键迁移功能不支持迁移账号和白名单。用户在迁移切换前需进行手动迁移。

步骤三：迁移切换：交换源RDS实例和目标GaiaDB集群的读写状态（即将源RDS实例修改为只读，将目标GaiaDB集群修改为读写），同时会更换复制方向（即将目标GaiaDB集群的新增数据同步到源RDS实例）。在切换的过程中，业务需要更换应用程序的链接地址为GaiaDB的地址。

步骤四：完成迁移：若业务数据迁移已完成，并且后续不再需要使用数据同步时，您可以完成整个升级过程。

迁移切换完成后，如果您发现数据存在异常或其他问题，可以进行切换回滚操作，以便迅速恢复到切换前的状态。之后，您还可以继续选择取消迁移操作，恢复到迁移之前的状态。

步骤一：从RDS迁移

在此步骤将创建一个与源RDS相同的GaiaDB实例，源RDS的存量和增量数据都将迁移同步至GaiaDB。

说明：

• 建议您先进行迁移评估，评估完成后再创建实例。
• 全量迁移期间不支持DDL操作，例如：ALTER TABLE、ALTER VIEW、CREATE FUNCTION、CREATE INDEX、CREATE PROCEDURE、CREATE TABLE、CREATE VIEW、DROP INDEX、DROP TABLE、RENAME TABLE、TRUNCATE TABLE。
• DTS当前不支持源端RDS表名中包含斜线。
• 迁移过程中请不要创建trigger、event等不支持的结构对象，将会导致迁移失败。
• 数据同步过程中源端高并发写入数据将导致迁移时间变长。
• GaiaDB的规格建议大于等于RDS，保证迁移的效率不受规格读写限制。
• 已存在DTS任务的RDS实例无法进行一键迁移，可能会出现数据不一致问题；
• 集群创建后开始从RDS实例同步数据，您需要在30天内完成迁移操作，超过30天将自动关闭迁移功能。

1. 登录云原生数据库GaiaDB控制台。
2. 在 GaiaDB 控制台的左上角，选择要在其中创建数据库集群的区域。
3. 在”云原生数据库GaiaDB 列表“页面，点击创建集群按钮，填写迁移评估任务的相关参数，配置完成后点击发起评估。参数说明如下：

详细参数配置，请参考购买包年包月集群和购买按量付费集群。

参数	说明
源RDS版本	将迁移的RDS实例的MySQL版本，例如：MySQL 8.0，MySQL 5.7，MySQL5.6
源RDS实例	将迁移的RDS实例ID，下拉选择对应版本可迁移的RDS实例。注：若RDS实例已经迁移过，将无法选择
目标GaiaDB引擎版本	迁移后GaiaDB的MySQL版本，例如：MySQL 8.0，MySQL 5.7

说明：

• 若RDS实例已经进行过迁移，将无法选择；
• 不支持源实例MySQL版本大于目标集群MySQL版本；
• 可选的源实例列表不包含代理和只读实例。不影响源实例的正常运行。如果查询不到“源RDS实例”信息请尝试切换“地域”查找源RDS实例。

4. 确认配置
   在右侧订单明细检查所选配置。确认配置信息后，点击去支付按钮进入付款页面。
5. 支付成功
   您选择“查看订单明细”查询订单，或选择“管理控制台”进入“云原生数据库GaiaDB-集群列表”。 系统会在后台创建云原生数据库GaiaDB集群 ，大概需要10～15分钟。创建成功后，您会收到创建云原生数据库GaiaDB集群成功的信息。
6. 查看集群
   购买成功后，返回“云原生数据库GaiaDB-集群列表”页面，可看到已创建的云原生数据库GaiaDB集群，集群将自动发起存量数据迁移，此时的集群状态为数据同步中。

步骤二：创建账号和设置白名单

一键迁移功能目前仅支持迁移数据，白名单和账号需要用户手动迁移。具体操作步骤如下。

说明：创建账号和白名单是迁移切换前的必备步骤，影响迁移后业务使用。

1. 设置白名单
2. 创建账号
3. 迁移完成白名单和账号后，等到复制延迟时间小于5秒后，可进行步骤三：迁移切换。

步骤三：迁移切换

当目标GaiaDB集群的复制延迟小于5秒时，即可进行迁移切换操作。

说明：

• 迁移切换前，建议手动在DTS控制台进行数据一致性校验，将提升迁移效率。
• 迁移切换后，源实例会变成只读状态，业务写请求将无法访问，请您修改应用配置。
• 迁移切换后，目标实例将变成读写状态，主地址支持访问。
• 切换时，请您关注切换状态，离开GaiaDB控制台将影响切换进程。
• 迁移切换完成后，在GaiaDB新建的数据库不会同步至源RDS实例，需用户在RDS实例手动创建。

1. 登录云原生数据库GaiaDB控制台。
2. 在 GaiaDB 控制台的找到目标集群，点击后进去集群详情页。
3. 在详情页上方，点击迁移切换。

4. 在切换业务到新数据库提示框中，展示对应的提示信息和源数据库和目标数据库的地址，用户需修改应用地址。点击确定将发起迁移切换。

5. 应用将自动发起数据校验等通过后，进行读写状态的切换，下方为切换完成的状态，GaiaDB实例为读写状态。

步骤四：完成迁移

说明：

• 若用户不在使用数据同步，可以选择完成迁移。点击后无法再次使用一键迁移功能。
• 您可以在完成迁移时同步选择是否关闭GaiaDB集群的Binlog。关闭Binlog会带来少量的写入性能提升，但关闭Binlog后GaiaDB集群会自动重启使新配置生效。

1. 登录云原生数据库GaiaDB控制台。
2. 在 GaiaDB 控制台的找到目标集群，点击后进去集群详情页。
3. 在详情页上方，点击完成迁移。

4. 确认提示框的信息，点击确定。源RDS实例和目标实例将无同步状态。