将MySQL迁移到MySQL_数据复制服务 DRS

支持的源和目标数据库

表1 支持的数据库
源数据库	目标数据库
本地自建数据库（MySQL 5.5、5.6、5.7、8.0版本） ECS自建数据库（MySQL 5.5、5.6、5.7、8.0版本）其他云上数据库（MySQL 5.5、5.6、5.7、8.0版本） RDS for MySQL（5.5、5.6、5.7、8.0版本）	RDS for MySQL（5.5、5.6、5.7、8.0版本）说明：仅支持目标库版本等于或高于源库版本。

支持的迁移对象范围

在使用DRS进行迁移时，不同类型的迁移任务，支持的迁移对象范围不同，详细情况可参考表2。DRS会根据用户选择，在“预检查”阶段对迁移对象进行自动检查。

表2 支持的迁移对象
类型名称	使用须知
迁移对象范围	迁移对象选择维度：支持选择表级、库级或实例级（全部迁移）。支持的迁移对象：支持数据库、表、用户、视图、索引、约束、函数、存储过程、触发器（TRIGGER）和事件（EVENT）的迁移。不支持系统库的迁移以及事件状态的迁移。不支持非MyISAM和非InnoDB表的迁移。相互关联的数据对象要确保同时迁移，避免迁移因关联对象缺失，导致迁移失败。常见的关联关系：视图引用表、视图引用视图、存储过程/函数/触发器引用视图/表、主外键关联表等。不支持外键级联操作。当外键是普通索引的时候，可能会导致表结构创建失败，建议改成唯一索引。说明：支持迁移的对象有如下限制：源数据库中的库名、表名、视图名不能包含：'<>`/\"以及非ASCII字符。源数据库中的库名不允许以ib_logfile开头，不能为ib_buffer_pool、ib_doublewrite、ibdata1、ibtmp1。

数据库账号权限要求

在使用DRS进行迁移时，连接源库和目标库的数据库账号需要满足以下权限要求，才能启动实时迁移任务。不同类型的迁移任务，需要的账号权限也不同，详细可参考表3进行赋权。DRS会在“预检查”阶段对数据库账号权限进行自动检查，并给出处理建议。

建议创建单独用于DRS任务连接的数据库帐号，避免因为帐号修改，导致的任务连接失败。
连接源和目标数据库的帐号密码修改后，请尽快修改DRS任务中的连接信息，避免任务连接失败后自动重试，导致数据库帐号被锁定影响使用。

表3 数据库账号权限
类型名称	全量迁移	全量+增量迁移
源数据库连接账号	需要具备如下最小权限： SELECT、SHOW VIEW、EVENT。用户迁移时，帐户需要有mysql.user的SELECT权限。	需要具备如下最小权限： SELECT、SHOW VIEW、EVENT、LOCK TABLES、REPLICATION SLAVE、REPLICATION CLIENT。用户迁移时，帐户需要有mysql.user的SELECT权限。
目标数据库连接账号	需要具备如下最小权限： SELECT、CREATE、ALTER、DROP、DELETE、INSERT、UPDATE、INDEX、EVENT、CREATE VIEW、CREATE ROUTINE、TRIGGER、REFERENCES、WITH GRANT OPTION。当目标库为8.0.14-8.0.18版本时，还需要有SESSION_VARIABLES_ADMIN权限。用户迁移时，需要有mysql库的SELECT、INSERT、UPDATE、DELETE权限。

使用建议

DRS任务启动和全量数据迁移阶段，请不要在源数据库执行DDL操作，否则可能导致任务异常。
如果您使用的是全量迁移模式，确保源和目标数据库无业务写入，保证迁移前后数据一致。如果您使用的是全量+增量迁移模式，支持在源数据库有业务数据写入的情况下进行迁移。

数据库迁移与环境多样性和人为操作均有密切关系，为了确保迁移的平顺，建议您在进行正式的数据库迁移之前进行一次演练，可以帮助您提前发现问题并解决问题。
基于以下原因，建议您在启动任务时选择“稍后启动”功能，将启动时间设置在业务低峰期，相对静止的数据可以有效提升一次性迁移成功率，避免迁移对业务造成性能影响。
- 在网络无瓶颈的情况下，全量迁移会对源数据库增加约50MB/s的查询压力，以及占用2~4个CPU。
- 迁移无主键表时，为了确保数据一致性，会存在3s以内的单表级锁定。
- 正在迁移的数据被其他事务长时间锁死，可能导致读数据超时。
- 由于MySQL固有特点限制，CPU资源紧张时，存储引擎为Tokudb的表，读取速度可能下降至10%。
- DRS并发读取数据库，会占用大约6-10个session连接数，需要考虑该连接数对业务的影响。
- 全量阶段读取表数据时，特别是大表的读取，可能会阻塞业务上对大表的独占锁操作。
数据对比
 建议您结合数据对比的“稍后启动”功能，选择业务低峰期进行数据对比，以便得到更为具有参考性的对比结果。由于同步具有轻微的时差，在数据持续操作过程中进行对比任务，可能会出现少量数据不一致对比结果，从而失去参考意义。

使用须知

DRS全量+增量迁移过程一般包含四个阶段：任务启动阶段、全量阶段、增量阶段、结束任务阶段（单全量任务则包含三个阶段）。为了确保迁移各个阶段的平顺，在创建迁移任务前，请务必阅读以下使用须知。

表4 使用须知
类型名称	使用和操作限制
任务启动前须知	源数据库参数要求：增量迁移时，源数据库的binlog日志必须打开，且binlog日志格式必须为Row格式。在磁盘空间允许的情况下，建议源数据库binlog保存时间越长越好，建议为3天。源数据库expire_logs_days参数值为0，可能会导致迁移失败。建议将expire_logs_day参数设置在合理的范围，确保恢复时断点处的binlog尚未过期，以保证任务中断后的顺利恢复。增量迁移时，必须设置MySQL源数据库的server_id。如果源数据库版本小于或等于MySQL5.6，server_id的取值范围在2－4294967296之间；如果源数据库版本大于或等于MySQL5.7，server_id的取值范围在1－4294967296之间。源数据库建议开启skip-name-resolve，减少连接超时的可能性。源数据库GTID状态建议为开启状态，源数据库实例没有开启GTID的情况下不支持主备倒换，DRS任务会因为位点不续接而中断导致无法恢复。源数据库log_slave_updates参数需设置为开启状态，否则会导致迁移失败。源数据库的binlog_row_image参数需设置为FULL，否则会导致迁移失败。源数据库对象要求：如果源数据库为自建库，并且安装了Percona Server for MySQL 5.6.x或Percona Server for MySQL 5.7.x时，内存管理器必须使用Jemalloc库，以避免因系统表频繁查询带来的内存回收不及时，并最终导致数据库Out of Memory问题。源数据库不支持mysql binlog dump命令。源数据库不支持reset master或reset master to命令，可能会导致DRS任务失败或者数据不一致。相互关联的数据对象要确保同时迁移，避免迁移因关联对象缺失，导致迁移失败。不支持外键级联操作。当外键是普通索引的时候，可能会导致表结构创建失败，建议改成唯一索引。由于MySQL本身限制，若源库的一次性事件（EVENT）设定的触发时间在迁移开始前，该事件（EVENT）不会迁移到目标库。目标数据库参数要求：目标数据库实例的运行状态必须正常。目标数据库实例必须有足够的磁盘空间。建议目标库的binlog日志格式为Row格式，否则增量迁移可能出错。建议目标库的事务隔离级别至少保证在已提交读。 DRS迁移时会有大量数据写入目标库，目标库max_allowed_packet 参数过小会导致无法写入，建议将目标库max_allowed_packet参数值设置大一点，使其大于100MB。目标数据库GTID状态建议为开启状态。目标数据库和源数据库字符集需保持一致，否则可能导致迁移失败。目标数据库的log_bin_trust_function_creators参数需设置为on，否则可能导致迁移失败。目标数据库和源数据库的server_uuid参数值需保持一致，否则将导致增量迁移失败。目标数据库和源数据库的collation_server参数值需保持一致，否则可能导致迁移失败。目标数据库和源数据库的time_zone参数值需保持一致，否则可能导致迁移失败。目标数据库和源数据库的sql_mode参数值需保持一致，否则可能导致迁移失败。目标数据库和源数据库的innodb_strict_mode参数值需保持一致，否则可能导致迁移失败。目标数据库和源数据库的lower_case_table_names参数需保持一致，否则可能导致迁移失败。迁移的对象中包含引擎为MyISAM的表，则目标数据库sql_mode不能包含no_engine_substitution参数，否则可能会导致迁移失败。目标数据库对象要求：除了MySQL系统数据库之外，目标数据库不能包含与源数据库同名的数据库。其他使用须知：多对一场景下，创建迁移任务时，目标库读写设置需要跟已有任务设置为一致。由于无主键表缺乏行的唯一性标志，网络不稳定时涉及少量重试，表数据存在少量不一致的可能性。不支持目标数据库恢复到全量迁移时间段范围内的PITR操作。源库和目标库为RDS for MySQL实例时，不支持带有TDE特性并建立具有加密功能表。如果源库MySQL不支持TLS1.2协议，或者为版本较低的自建库（低于5.6.46或在5.7-5.7.28之间），需提交运维申请才能使用SSL测试连接。迁移任务目标数据库可以设置“只读”和“读写”。只读：目标数据库实例将转化为只读、不可写入的状态，迁移任务结束后恢复可读写状态，此选项可有效的确保数据迁移的完整性和成功率，推荐此选项。读写：目标数据库可以读写，但需要避免操作或接入应用后会更改迁移中的数据（注意：无业务的程序常常也有微量的数据操作），进而形成数据冲突、任务故障、且无法修复续传，充分了解要点后可选择此选项。
全量迁移阶段须知	任务启动和全量数据迁移阶段，请不要在源数据库执行DDL操作，否则可能导致任务异常。迁移过程中，不允许修改、删除连接源和目标数据库的用户的用户名、密码、权限，或修改源和目标数据库的端口号。迁移过程中，不允许对正在迁移中的目标数据库进行修改操作（包括但不限于DDL、DML操作）。迁移过程中，不允许源库写入binlog格式为statement的数据。迁移过程中，不允许源库执行清除binlog的操作。迁移过程中，不允许在源库创建库名为ib_logfile的数据库。
增量迁移阶段须知	迁移过程中，不允许修改、删除连接源和目标数据库的用户的用户名、密码、权限，或修改源和目标数据库的端口号。迁移过程中，不允许对正在迁移中的目标数据库进行修改操作（包括但不限于DDL、DML操作）。迁移过程中，不允许源库写入binlog格式为statement的数据。迁移过程中，不允许源库执行清除binlog的操作。迁移过程中，不允许在源库创建库名为ib_logfile的数据库。选择表级对象迁移时，增量迁移过程中不支持对表进行重命名操作。增量迁移阶段，不支持源数据库进行恢复到某个备份点的操作（PITR）。增量迁移阶段，支持断点续传功能，在主机系统崩溃的情况下，对于非事务性的无主键的表可能会出现重复插入数据的情况。增量迁移阶段支持DDL语句。当源和目标库是同一个大版本且为整实例迁移时，增量迁移支持DCL语句，不支持通过更新mysql.user表进行的账号变更。相关DCL语句可参考MySQL官网文档。
结束任务使用须知	任务正常结束在结束迁移任务时，将进行所选事件（EVENT）和触发器（TRIGGER）的迁移。请确保任务结束前，不要断开源和目标数据库的网络连通性，并在结束任务时关注迁移日志上报的状态，达到数据库完整迁移效果。任务强制结束强制结束将直接释放DRS资源，不会进行触发器、事件的迁移，请手工迁移触发器、事件。如果需要DRS进行触发器、事件迁移，请先修复DRS任务，待任务状态正常后，再正常结束任务。

前提条件

已登录数据复制服务控制台。
满足实时迁移支持的数据库类型和版本，详情请参见实时迁移。

已阅读以上使用建议和使用须知。

操作步骤

本节将以MySQL到RDS for MySQL的迁移为示例，介绍在VPC网络场景下，通过数据复制服务管理控制台配置数据迁移任务的流程。

在“实时迁移管理”页面，单击“创建迁移任务”，进入创建迁移任务页面。

在“迁移实例”页面，填选任务名称、描述、迁移实例信息，单击“下一步”。

任务信息

图1 迁移任务信息

表5 任务和描述
参数	描述
任务名称	任务名称在4-50位之间，必须以字母开头，可以包含字母、数字、中划线或下划线，不能包含其他的特殊字符。
描述	描述不能超过256位，且不能包含! = < > & ' " \ 特殊字符。

迁移实例信息

表6 迁移实例信息
参数	描述
数据流动方向	选择入云。入云指目标数据库为本云数据库的场景。
源数据库引擎	选择“MySQL”。
目标数据库引擎	选择“MySQL”。
网络类型	此处选择“VPC网络”。默认为“公网网络”类型，可按照需求选择“VPC网络”、“公网网络”和“VPN、专线网络”。 VPC网络：适合云上同Region数据库之间的迁移。公网网络：适合通过公网网络把其他云下或其他平台的数据库迁移到目标数据库，该类型要求目标数据库绑定弹性公网IP（EIP）。 VPN、专线网络：适合通过专线网络，实现其他云下自建数据库与云上数据库迁移、或云上跨Region的数据库之间的迁移。
目标数据库实例	用户所创建的本云关系型数据库实例。
迁移实例所在子网	选择迁移实例所在的子网。也可以单击“查看子网”，跳转至“网络控制台”查看实例所在子网帮助选择。默认值为当前所选数据库实例所在子网，请选择有可用IP地址的子网。为确保迁移实例创建成功，仅显示已经开启DHCP的子网。
目标库读写设置	只读迁移中，目标数据库实例将转化为只读、不可写入的状态，迁移任务结束后恢复可读写状态，此选项可有效的确保数据迁移的完整性和成功率，推荐此选项。读写迁移中，目标数据库可以读写，但需要避免操作或接入应用后会更改迁移中的数据（注意：无业务的程序常常也有微量的数据操作），进而形成数据冲突、任务故障、且无法修复续传，充分了解要点后可选择此选项。如果目标库有其他数据库需要在迁移时被业务使用，可设置该选项为读写。任务创建后不能修改。
迁移模式	全量：该模式为数据库一次性迁移，适用于可中断业务的数据库迁移场景，全量迁移将非系统数据库的全部数据库对象和数据一次性迁移至目标端数据库，包括：表、视图、存储过程等。说明：如果用户只进行全量迁移时，建议停止对源数据库的操作，否则迁移过程中源数据库产生的新数据不会同步到目标数据库。全量+增量：该模式为数据库持续性迁移，适用于对业务中断敏感的场景，通过全量迁移过程中完成的目标端数据库的初始化后，增量迁移阶段通过解析日志等技术，将源端和目标端数据库保持数据持续一致。说明：选择“全量+增量”迁移模式，增量迁移可以在全量迁移完成的基础上实现数据的持续同步，无需中断业务，实现迁移过程中源业务和数据库继续对外提供访问。

对于创建失败的任务，DRS默认保留3天，超过3天将会自动结束任务。

在“源库及目标库”页面，迁移实例创建成功后，填选源库信息和目标库信息，单击“源库和目标库”处的“测试连接”，分别测试并确定与源库和目标库连通后，勾选协议，单击“下一步”。

此处源库类型分为ECS自建库和RDS实例，需要根据源数据库的实际来源选择相应的分类。两种场景下的参数配置不一样，需要根据具体场景进行配置。

场景一：ECS自建库源库信息配置

表7 ECS自建库场景源库信息
参数	描述
源库类型	选择ECS自建库。
VPC	源数据库实例所在的虚拟专用网络，可以对不同业务进行网络隔离。您需要创建或选择所需的虚拟私有云。
子网	通过子网提供与其他网络隔离的、可以独享的网络资源，以提高网络安全。子网在可用分区内才会有效，创建源数据库实例的子网需要开启DHCP功能，在创建过程中也不能关闭已选子网的DHCP功能。
IP地址或域名	源数据库的IP地址或域名。
端口	源数据库服务端口，可输入范围为1~65535间的整数。
数据库用户名	源数据库的用户名。
数据库密码	源数据库的用户名所对应的密码。
SSL安全连接	通过该功能，用户可以选择是否开启对迁移链路的加密。如果开启该功能，需要用户上传SSL CA根证书。说明：最大支持上传500KB的证书文件。如果不使用SSL证书，请自行承担数据安全风险。

源数据库的IP地址或域名、数据库用户名和密码，会被系统加密暂存，直至删除该迁移任务后自动清除。

场景二：RDS实例源库信息配置

表8 RDS实例场景源库信息
参数	描述
源库类型	选择RDS实例。
数据库实例名称	选择待迁移的关系型数据库实例作为源数据库实例。
数据库用户名	源数据库实例的用户名。
数据库密码	源数据库的用户名所对应的密码。

目标库信息配置

表9 目标库信息
参数	描述
数据库实例名称	默认为创建迁移任务时选择的关系型数据库实例，不可进行修改。
数据库用户名	目标数据库对应的数据库用户名。
数据库密码	目标数据库的登录密码。
所有Definer迁移到该用户下	是否迁移后，将保持源数据库对象Definer定义不变，选择此选项，需要配合下一步用户权限迁移功能，将源数据库的用户全部迁移，这样才能保持源数据库的权限体系完全不变。

数据库用户名和密码将被系统加密暂存，直至该任务删除后清除。

在“迁移设置”页面，设置迁移用户和迁移对象，单击“下一步”。

图2 迁移模式

**表10** 迁移模式和迁移对象
参数	描述
流速模式	流速模式支持限速和不限速，默认为不限速。限速自定义的最大迁移速度，迁移过程中的迁移速度将不会超过该速度。当流速模式选择了“限速”时，你需要通过流速设置来定时控制迁移速度。流速设置通常包括限速时间段和流速大小的设置。默认的限速时间段为全天限流，您也可以根据业务需求自定义时段限流。自定义的时段限流支持最多设置3个定时任务，每个定时任务之间不能存在交叉的时间段，未设定在限速时间段的时间默认为不限速。流速的大小需要根据业务场景来设置，不能超过9999MB/s。图3 设置流速模式不限速对迁移速度不进行限制，通常会最大化使用源数据库的出口带宽。该流速模式同时会对源数据库造成读消耗，消耗取决于源数据库的出口带宽。比如源数据库的出口带宽为100MB/s，假设高速模式使用了80%带宽，则迁移对源数据库将造成80MB/s的读操作IO消耗。说明：限速模式只对全量迁移阶段生效，增量迁移阶段不生效。您也可以在创建任务后修改流速模式。具体方法请参见修改流速模式。
迁移用户	数据库的迁移过程中，迁移用户需要进行单独处理。常见的迁移用户一般分为三类：可完整迁移的用户、需要降权的用户和不可迁移的用户。您可以根据业务需求选择迁移或者不迁移，选择“是”后，可根据需要选择迁移用户。是当您选择迁移用户时，请参见迁移用户章节进行数据库用户、权限及密码的处理。否迁移过程中，将不进行数据库用户、权限和密码的迁移。
过滤DROP DATABASE	实时迁移过程中，为了降低迁移数据的风险，数据复制服务提供了过滤删除数据库操作的功能。是，表示实时迁移过程中不会迁移用户在源数据库端执行的删除数据库的操作。否，则表示实时迁移过程中将相关操作迁移到目标库。
迁移对象	您可以根据业务需求，选择全部对象迁移、表级迁移或者库级迁移。全部迁移：将源数据库中的所有对象全部迁移至目标数据库，对象迁移到目标数据库实例后，对象名将会保持与源数据库实例对象名一致且无法修改。表级迁移：将选择的表级对象迁移至目标数据库。库级迁移：将选择的库级对象迁移至目标数据库。如果有切换源数据库的操作或源库迁移对象变化的情况，请务必在选择迁移对象前单击右上角的，以确保待选择的对象为最新源数据库对象。说明：若选择部分数据库进行迁移时，由于存储过程、视图等对象可能与其他数据库的表存在依赖关系，若所依赖的表未迁移，则会导致迁移失败。建议您在迁移之前进行确认，或选择全部数据库进行迁移。当对象名称包含空格时，名称前后的空格不显示，中间如有多个空格只显示一个空格。选择的迁移对象名称中不能包含空格。选择对象的时候支持搜索，以便您快速选择需要的数据库对象。

在“预检查”页面，进行迁移任务预校验，校验是否可进行迁移。
- 查看检查结果，如有不通过的检查项，需要修复不通过项后，单击“重新校验”按钮重新进行迁移任务预校验。
  图4 预检查
- 预检查完成后，且预检查通过率为100%时，单击“下一步”。
  
  所有检查项结果均通过时，若存在待确认项，需要阅读并确认详情后才可以继续执行下一步操作。
进入“参数对比”页面，进行参数对比。
参数对比功能从常规参数和性能参数两个维度，展示了源数据库和目标数据库的参数值是否一致。您可以根据业务需求，决定是否选用该功能。该操作不影响数据的迁移，主要目的是为了确保迁移成功后业务应用的使用不受影响。
- 若您选择不进行参数对比，可跳过该步骤，单击页面右下角“下一步”按钮，继续执行后续操作。
- 若您选择进行参数对比，请参照如下的步骤操作。
  一般情况下，对于常规参数，如果源库和目标库存在不一致的情况，建议将目标数据库的参数值通过“一键修改”按钮修改为和源库对应参数相同的值。
  
  对于性能参数，您可以根据业务场景，自定义源数据库和目标库的参数值，二者结果可以一致也可以不一致。
  - 若您需要将对比结果一致的性能参数修改为不一致，需要在“目标库值调整为”一列手动输入需要调整的倍数或结果，单击左上角“一键修改”按钮，即可将源数据库和目标数据库对应的性能参数值改为不一致。
  - 若您想将对比结果不一致的参数改为一致结果，请参考如下流程进行修改：
    1. 对齐源库和目标库的参数值。
      当源库和目标库对应的参数值出现不一致时，选择需要修改的参数，单击“一键对齐”按钮，系统将帮您自动填充目标数据库的参数值，使其和源库对应的参数值保持一致。
      
      对齐参数值的操作，您也可以通过手动输入调整的倍数或结果。
    2. 修改参数值。
      源库和目标库的不一致参数值对齐后，单击“一键修改”按钮，系统将按照您当前设置的目标库参数值进行修改。修改完成后，目标库的参数值和对比结果会自动进行更新。
      
      部分参数修改后无法在目标数据库立即生效，需要重启才能生效，此时的对比结果显示为“待重启，不一致”。建议您在迁移任务启动之前重启目标数据库，或者迁移结束后选择一个计划时间重启。如果您选择迁移结束后重启目标数据库，请合理设置重启计划时间，避免参数生效太晚影响业务的正常使用。
      
      在进行参数对比功能时，您可以参见参数对比列表章节进行参数设置。
    3. 参数对比操作完成后，单击“下一步”。

在“任务确认”页面，设置迁移任务的启动时间，并确认迁移任务信息无误后，单击“启动任务”，提交迁移任务。

**表11** 任务启动设置
参数	描述
启动时间	迁移任务的启动时间可以根据业务需求，设置为“立即启动”或“稍后启动”，优选“稍后启动”。说明：预计迁移任务启动后，会对源数据库和目标数据库的性能产生影响，建议您将任务启动时间设定在业务低峰期，同时预留2-3天校对数据。

迁移任务提交后，您可在“实时迁移管理”页面，查看并管理自己的任务。
- 您可查看任务提交后的状态，状态请参见任务状态说明。
- 在任务列表的右上角，单击刷新列表，可查看到最新的任务状态。
- 对于未启动、状态为配置中的任务，DRS默认保留3天，超过3天DRS会自动删除后台资源，当前任务状态不变。当用户再次配置时，DRS会重新申请资源。

将MySQL迁移到MySQL