文档首页/ 数据复制服务 DRS/ 用户指南（吉隆坡区域）/ 实时同步/ 入云/ 将MySQL同步到GaussDB(DWS)
更新时间：2025-08-07 GMT+08:00
查看PDF
分享

将MySQL同步到GaussDB(DWS)

支持的源和目标数据库

表1 支持的数据库

源数据库

目标数据库
  • 本地自建MySQL数据库（MySQL 5.5、5.6、5.7、8.0版本）
  • ECS自建MySQL数据库（MySQL 5.5、5.6、5.7、8.0版本）
  • 其他云上MySQL数据库（MySQL 5.5、5.6、5.7、8.0版本）
  • RDS for MySQL（5.5、5.6、5.7、8.0版本）
  • TaurusDB标准版（5.7、8.0版本）

GaussDB(DWS)（8.1.3、8.2.0版本）

目前为受限使用阶段。

数据库账号权限要求

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

表2 数据库账号权限

类型名称

全量同步、增量同步、全量+增量同步

源数据库连接账号

需要具备如下最小权限：

SELECT、LOCK TABLES、REPLICATION SLAVE、REPLICATION CLIENT。

目标数据库连接账号

目标数据库的每张表必须具有如下权限：INSERT、SELECT、UPDATE、DELETE、CONNECT、CREATE。
  • 建议创建单独用于DRS任务连接的数据库账号，避免因为数据库账号密码修改，导致的任务连接失败。
  • 连接源和目标数据库的账号密码修改后，请参考修改连接信息章节修改DRS任务的连接信息，避免任务连接失败后自动重试，导致数据库账号被锁定影响使用。

支持的同步对象范围

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

表3 支持的同步对象

类型名称

使用须知

同步对象范围
  • 支持同步表、普通索引（B-Tree索引）、约束（主键、空、非空）。
  • 支持同步MyISAM和InnoDB表。
  • 全量同步支持comment，增量同步不支持。
  • 不支持同步视图、外键、存储过程、触发器、函数、事件、虚拟列、唯一约束和唯一索引。
  • 不支持同步既是无主键表，又是分区表的自建表。
  • 不支持GaussDB(DWS)的无主键复制表，如果需要同步的表在GaussDB(DWS)为无主键复制表，会导致任务失败。
  • 同步对象列名不能为CTID、XMIN、CMIN、XMAX、CMAX、TABLEOID、XC_NODE_ID、TID等GaussDB(DWS)禁止的字段，否则会导致任务失败。
  • 全量和增量同步不支持隐藏列（INVISIBLE），隐藏列是MySQL 8.0.23开始支持的特性，例如： 
    CREATE TABLE `test11` (
  `id` int NOT NULL,
  `c1` int DEFAULT NULL /*!80023 INVISIBLE */,
  PRIMARY KEY (`id`));

注意事项

为保证任务的正常运行，DRS提供了自动化的检查方法，在您启动DRS任务前，会针对源数据库和目标数据库的相关配置、条件进行检查。主要的检查项和对应的处理建议请参考预检查项。除了预检查项目之外，您还需要注意的事情参见表4。

表4 注意事项

类型名称

使用和操作限制

源数据库限制
  • 源数据库中的库名、表名不能包含：.<'>/\"以及非ASCII字符。源数据库表名不支持对象名中带有不闭环的左大括号{，对象名包含表名、索引名、分区名、列名等 。
  • 源数据库中表结构的列名不能以\字符结尾。
  • 不支持reset master或reset master to命令，可能会导致DRS任务失败或者数据不一致。
  • 如果源数据库MySQL不支持TLS1.2协议，或者为版本较低的自建库（低于5.6.46或在5.7.0-5.7.28之间），需提交运维申请才能使用SSL测试连接。

使用限制

通用：

  • 实时同步过程中，若源库为RDS时，支持修改端口，修改之后同步任务失败，需要通过重试后继续进行同步。
  • 实时同步过程中，若源库为非RDS时，不支持修改端口。
  • 实时同步过程中，不支持IP、账号、密码修改。
  • 不允许源数据库进行恢复操作。
  • 不支持强制清理Binlog。
  • 实时同步过程中，不允许源数据库MySQL跨大版本升级，否则可能导致数据不一致或者同步任务失败（跨版本升级后数据、表结构、关键字等信息均可能会产生兼容性改变），建议在该场景下重建同步任务。
  • MySQL5.6及之前版本字符类型中允许存入乱码数据，乱码数据无法被正常查询，无法保证乱码数据同步后的数据一致性。

全量同步阶段：

  • 任务启动和全量数据同步阶段，请不要在源数据库执行DDL操作，否则可能导致任务异常。

增量同步阶段：

  • 如果设置session变量character_set_client为binary，可能导致乱码。
  • 增量同步过程中，不支持delete和update目标端主键类型为binary，text，blob，clob的表。
  • 库级同步新建的无主键表必须包含以下列中的其中之一。

    INTEGER TYPES: TINYINT、SMALLINT、INT、BIGINT、NUMERIC/DECIMAL；

    CHARACTER TYPES: CHAR、BPCHAR、VARCHAR、VARCHAR2、NVARCHAR2；

    DATE/TIME TYPES: DATE、TIME、TIMETZ、TIMESTAMP、TIMESTAMPTZ、INTERVAL、SMALLDATETIME；

    无主键表会指定可作为分布列的其中一列作为分布列，如果所有列类型都无法作为分布列，会导致建表失败，DRS同步中断。

  • 增量同步过程中，不支持指定位置加列的DDL操作（例如ALTER TABLE ddl_test ADD COLUMN c2 AFTER/FIRST c1;），DRS会删除AFTER/FIRST属性，可能会导致列顺序不一致。
  • 增量同步过程中，执行不幂等的DDL可能导致数据不一致（例如ALTER TABLE ddl_test ADD COLUMN c3 timestamp default now();），DRS会因数据库函数执行结果不幂等导致最终数据不一致。
  • 增量同步过程中支持DDL操作。
    • 一对一的场景下，默认同步的DDL类型有CREATE_TABLE，RENAME_TABLE，ADD_COLUMN，MODIFY_COLUMN，ALTER_COLUMN，DROP_CONSTRAINT、ADD_CONSTRAINT、CREATE_INDEX，DROP_INDEX，RENAME_INDEX，RENAME_COLUMN，客户可以根据自身需求，在对象选择页面选择需要同步的DDL类型。
    • 多对一场景下，执行column重命名操作，必须停业务操作，不然会有数据不一致的风险。
    • 多对一场景下，推荐只同步加列DDL，其他的DDL同步可能会因为目标表被修改而导致任务失败或数据不一致。
    • 多对一场景下，执行ADD_COLUMN时，需保证每张表加列的类型一致，否则有可能导致任务失败。
    • 新增和修改表名、列名、索引名时不能超出63字符，否则任务会失败。
    • 执行DDL语句创建索引时，语句中表名+索引名超出63字符可能出现重名情况，造成索引创建失败。
    • 源库无主键表增加主键的时候，必须含有第一列，否则任务会失败。
    • 增量阶段执行DDL操作时，如果目标表不存在，则该DDL会被忽略掉。
    • 增量阶段，源数据库执行CHANGE COLUMN修改列信息，如果该列在目标数据库GaussDB(DWS)中为分布列，则该语句会被忽略，因为GaussDB(DWS)不支持修改分布列。
    • 增量阶段，由于源和目标数据库索引规则不一样，所以不支持RENAME INDEX的DDL操作。
    • 增量阶段，不建议CHAR(0)与其他字符拼接进行同步，例如插入CONCAT('a',CHAR(0),'b'），可能造成数据不一致。
    • 增量阶段，JSON数据类型里不建议CHAR(34)（双引号）、CHAR(92)（反斜杠）与其他字符拼接进行同步，例如插入JSON_OBJECT('$.0', CONCAT('a', CHAR(34), 'b'))，同步到目标端后会多出一个反斜杠，造成数据不一致。

结束任务：

  • 任务正常结束：

    请确保任务结束前，不要断开源和目标数据库的网络连通性，并在结束任务时关注同步日志上报的状态，达到数据库完整同步效果。

  • 任务强制结束：

    强制结束将直接释放DRS资源。

其他限制
  • 相互关联的数据对象要确保同时同步，避免因关联对象缺失，导致同步失败。常见的关联关系：索引引用表等。
  • 不支持源数据库进行恢复操作。
  • 不支持强制清理binlog，否则会导致同步任务失败。
  • 同步无主键表时，如果存在唯一键，可能因数据冲突导致写入失败。
  • 不建议在数据库中使用非精确数值类型做主键，该特性影响DRS增量场景下对UPDATE、DELETE语句的同步，导致任务失败。
  • 如果无主键表中包含大字段（blob、text、clob、nclob、bytea），增量同步阶段存在大字段数据不一致的可能性。
  • 源库为RDS for MySQL实例时，支持源数据库多张表对GaussDB(DWS)一张表的映射。详细操作可参考创建MySQL到GaussDB(DWS)同步任务。
  • 在创建DRS任务之前，如果源数据库实例开启并设置了SQL限流规则，可能会导致DRS任务失败。
  • MySQL 5.7版会过滤check约束，如果源数据库为5.7版时，不建议使用check约束，可能会导致数据不一致。
  • 网络中断在30秒内恢复的，不影响实时同步，如果超过30秒，则会导致同步任务失败。
  • MySQL的唯一约束（unique key）在同步到目标数据库GaussDB(DWS)后会改写成普通约束，主键（primary key）的同步保持不变。
  • 支持目标数据库中的表比源数据库多列场景，但是需要避免以下场景可能导致的任务失败。
    • 目标数据库多的列要求非空且没有默认值，源数据库insert数据，同步到目标数据库后多的列为null，不符合目标数据库要求。
    • 目标数据库多的列设置固定默认值，且有唯一约束。源数据库insert多条数据后，同步到目标数据库后多的列为固定默认值，不符合目标数据库要求。
  • 在MySQL中，同一个database（schema）下面的不同表可以存在相同的索引名或约束名。而目标端GaussDB(DWS)中，同一个schema中索引和约束名是唯一的，且长度存在上限。为防止索引和约束名冲突，DRS同步到目标表上的索引名称将变为此格式：哈希值+原索引名（可能被截断）+_key。其中哈希值由“原库名_原表名_原索引名”计算得到。同理，表上的原约束名将变为：哈希值+原约束名（可能被截断）+_key，或表名_原索引名。
  • 全量阶段基于索引实现上差异，只保留普通B-Tree索引，其他索引默认不同步。GaussDB(DWS)索引过多时会影响存储空间和入库性能，建议用户可根据业务需求按需建索引。
  • DRS全量同步表结构时，源库中char、varchar、nvarchar、enum、set字符类型长度在目标库会按照字节长自动扩大（因为目标库为字节长）。
  • 全量同步分区表的结构时会将该对象转为非分区的普通表，增量同步时，源库跟分区表相关的操作，可能无法同步到目标库或者在目标库执行失败。增量阶段同步分区表会依赖GaussDB(DWS)支持的类型创建分区表，可能会创建失败。
  • 全量同步timestamp类型时，默认值中的on update current_timestamp语法将不会同步到目标库GaussDB(DWS)中。
  • 已选择的表与未选择的表之间互相rename的DDL操作，在任务同步中会被过滤掉，可能会导致任务失败或数据不一致。
    • 对于一个DDL中存在一个rename的情况（例如：rename A TO B），只支持rename前后库表都在已选择库表中的rename操作（A和B都在已选择库表中），其他情况的rename DDL会被过滤。
    • 对于一个DDL中存在多个rename的情况（例如：rename A TO B, B TO C），只支持rename前后库表都在已选择库表中的部分rename操作 ，其他情况的rename DDL会被过滤（A和B在已选择库表中，C不在，仅执行rename A TO B）。
    • 不建议在多对一同步场景下的进行rename操作，可能会导致任务失败或数据不一致。
  • 增量同步DDL中的SQL来源于用户执行的原生SQL，全量同步的表结构语法是经过SQL语法层处理之后的SQL语句，两者之前存在一些类型或者约束差异，可能会导致全量和增量创建的结构或者字段类型不同。
  • 源数据库同步的表如果有AUTO_INCREMENT属性，结束任务时，DRS会自动刷新同步表的序列整型列所对应的GaussDB自增列（sequence）起始值，刷新值为该列的最大值+10000。

操作步骤

本小节以RDS for MySQL到GaussDB(DWS)多对一场景的实时同步为示例，介绍如何使用数据复制服务配置实时同步任务。

  1. 在“实时同步管理”页面，单击“创建同步任务”。
  2. 在“同步实例”页面，填选任务名称、描述、同步实例信息，单击“开始创建”。

    • 任务信息
      表5 任务和描述

      参数

      描述

      任务名称

      任务名称在4到50位之间，必须以字母开头，可以包含字母、数字、中划线或下划线，不能包含其他的特殊字符。

      描述

      描述不能超过256位，且不能包含! = < > & ' " \ 特殊字符。
    • 同步实例信息

      表6 同步实例信息

      参数

      描述

      数据流动方向

      选择“入云”。

      源数据库引擎

      选择“MySQL”。

      目标数据库引擎

      选择“GaussDB(DWS)”。

      网络类型

      此处以“VPC网络”为示例。目前支持可选“公网网络”、“VPC网络”和“VPN、专线网络”。

      • VPC网络：适合云上同账号同Region同VPC场景下数据库之间的同步。
      • 公网网络：适合通过公网网络把其他云下或其他平台的数据库同步到目标数据库，该类型要求数据库绑定弹性公网IP（EIP）。
      • VPN、专线网络：适合VPN、专线、CC、VPCEP、或者用户已打通VPC对等连接的网络场景，实现其他云下自建数据库与云上数据库同步、云上同Region跨账号、或云上跨Region的数据库之间的同步。

      目标数据库实例

      可用的GaussDB(DWS)实例。

      同步实例所在子网

      请选择同步实例所在的子网。也可以单击“查看子网”，跳转至“网络控制台”查看实例所在子网帮助选择。

      默认值为当前所选数据库实例所在子网，请选择有可用IP地址的子网。为确保同步实例创建成功，仅显示已经开启DHCP的子网。

      IP类型

      选择同步实例的IP类型，目前支持选择“IPv4”或“IPv4&IPv6双栈”。

      • 只有所选择的VPC及子网都开启了IPv6双栈功能，才能选择IP类型为“IPv4&IPv6双栈”。
      • 选择“IPv4&IPv6双栈”时，如果源或者目标数据库是通过选择实例的方式进行连接，DRS会优先通过IPv4地址进行访问。

      同步模式

      DRS任务支持的同步模式，此处以“全量+增量”为示例。

      • 全量+增量

        该模式为数据持续性实时同步，通过全量过程完成目标端数据库的初始化后，增量同步阶段通过解析日志等技术，将源端和目标端数据保持数据持续一致。

        说明：

        选择“全量+增量”同步模式，增量同步可以在全量同步完成的基础上实现数据的持续同步，无需中断业务，实现同步过程中源业务和数据库继续对外提供访问。

      • 全量

        该模式为数据库一次性同步，适用于可中断业务的数据库同步场景，全量同步将用户选择的数据库对象和数据一次性同步至目标端数据库。

      • 增量

        该模式通过解析日志等技术，将源端产生的增量数据持续同步至目标端数据库。

      指定公网IP

      网络类型选择“公网网络”时可见，选择为DRS实例绑定的弹性公网IP。任务创建时，DRS将会自动绑定该弹性公网IP，等待任务结束后将自动解绑该弹性公网IP。
    • 任务类型
      表7 任务类型信息

      参数

      描述

      可用区

      DRS任务创建的可用区，选择跟源或目标库相同的可用区性能更优。
    • 标签

      表8 标签

      参数

      描述

      标签
      • 可选配置，对同步任务的标识。使用标签可方便管理您的任务。每个任务最多支持20个标签配额。
      • 如果您的组织已经设定DRS的相关标签策略，则需按照标签策略规则为任务添加标签。标签如果不符合标签策略的规则，则可能会导致任务创建失败，请联系组织管理员了解标签策略详情。
      • 任务创建成功后，您可以单击任务名称，在“标签”页签下查看对应标签。关于标签的详细操作，请参见标签管理。

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

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

    表9 源库信息

    参数

    描述

    数据库类型

    源数据库类型，可选“自建库”和“RDS实例”，此处以“RDS实例”为示例。

    数据库实例名称

    选择待同步的RDS实例。

    数据库用户名

    源数据库的用户名。

    数据库密码

    源数据库的用户名所对应的密码。

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

    表10 目标库信息

    参数

    描述

    数据库实例名称

    默认为创建同步任务时选择的GaussDB(DWS)实例，不可进行修改。

    数据库用户名

    目标数据库对应的数据库用户名。

    数据库密码

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

  4. 在“设置同步”页面，选择同步对象类型和同步对象。单击“下一步”。

    表11 同步模式和对象

    参数

    描述

    流速模式

    流速模式支持限速和不限速，默认为不限速。限速模式只对全量阶段生效，增量阶段不生效。

    • 限速

      自定义的最大同步速度，具体速度受网络等多种因素的影响，同步过程中每个任务（多任务时为每个子任务）的同步速度将不会超过该速度。

      当流速模式选择了“限速”时，您需要通过流速设置来定时控制同步速度。流速设置通常包括限速时间段和流速大小的设置。默认的限速时间段为“全天限流”，您也可以根据业务需求选择“时段限流”。自定义的时段限流支持最多设置10个定时任务，每个定时任务之间不能存在交叉的时间段，未设定在限速时间段的时间默认为不限速。

      流速的大小需要根据业务场景来设置，不能超过9999MB/s。

    • 不限速
      对同步速度不进行限制，通常会最大化使用源数据库的出口带宽。该流速模式同时会对源数据库造成读消耗，消耗取决于源数据库的出口带宽。比如源数据库的出口带宽为100MB/s，假设高速模式使用了80%带宽，则同步对源数据库将造成80MB/s的读操作IO消耗。
      说明：
      • 限速模式只对全量阶段生效，增量阶段不生效。
      • 您也可以在创建任务后修改流速模式。具体方法请参见修改流速模式。

    全量同步对象类型

    全量同步对象类型，可选同步表结构、同步数据、同步索引，根据实际需求进行选择要同步内容。

    • 同步数据为必选项。
    • 选择同步表结构的时候目标库不能有同名的表。
    • 不选同步表结构的时候目标库必须有相应的表，且要保证表结构与所选表结构相同。

    由于GaussDB(DWS)的表结构具有业务逻辑，建议结合业务情况在GaussDB(DWS)专家指导下自建表结构，并确保表名、列名、列类型的准确性，否则会出现数据同步失败、数据同步精度丢失等情况。

    增量阶段冲突策略

    该冲突策略特指增量同步中的冲突处理策略，全量阶段的冲突默认忽略。冲突策略目前支持如下形式：

    • 忽略

      当同步数据与目标数据库已有数据冲突时（主键/唯一键存在重复等），将跳过冲突数据，继续进行后续同步。选择忽略可能导致源库与目标库数据不一致。

    • 报错

      当同步数据与目标数据库已有数据冲突时（主键/唯一键存在重复等），同步任务将失败并立即中止。

    • 覆盖

      当同步数据与目标数据库已有数据冲突时（主键/唯一键存在重复等），将覆盖原来的冲突数据。

    异常数据策略

    源和目标数据库的客观差异差异，可能导致部分数据无法写入成功，出现异常数据，请选择出现异常数据时的任务策略。

    • 任务继续：不因少量异常数据导致全部数据均停止同步，异常数据发生时将会自动记录脏数据，可在“异常数据”模块查看这部分数据。
    • 任务失败：出现异常数据后，任务失败停止。

    DML同步

    选择需要同步的DML操作，默认都勾选。

    不勾选Delete则不会同步源库增量数据中的Delete语句，可能会导致数据不一致，因此存在数据冲突或任务失败的风险。

    启动位点

    步骤2的同步模式选择“增量”时可见，增量同步的启动位点，任务的源库日志从位点后开始获取（不含当前启动位点）。

    通过show master status命令获取源库位点，根据提示分别填写File、Position、Executed_Gtid_Set。

    增量支持DDL

    选择增量同步的DDL类型，用户根据需求可选择“默认值”或“自定义”。

    • “默认值”：
      • 库级同步情况下，Binlog中权限类DDL除外，所有库内对象相关DDL将会同步至目标，常见的DDL有CREATE_TABLE，RENAME_TABLE等。
      • 表级同步情况下，已选定的同步表相关在Binlog中DDL将全部同步，与同步表无关的对象DDL将不同步。常见的DDL有ADD_COLUMN，MODIFY_COLUMN，ALTER_COLUMN等。
    • “自定义”：用户根据需求，选择需要同步的DDL类型，不同链路支持的DDL类型以界面显示为准。

    同步对象

    左侧框是源数据库对象，右侧框是已经选择的对象，可选表级同步、库级同步，您可以根据业务场景选择对应的数据进行同步。

    • 如果同步的对象在源数据库和目标数据库中的命名不同，可在右侧已选对象框中修改目标库对象映射名称。也可通过对象名映射功能实现多张表对一张表的同步，具体操作可参考对象名修改（对象名映射）。
      • 使用多对一操作时，需要使用数据加工的附加列操作来避免数据冲突。
      • 源库和目标库多对一的表的结构要一致。
    说明：
    • 选择数据的时候支持对展开的库搜索，以便您快速选择需要的数据库对象。
    • 如果有切换源数据库的操作或源库同步对象变化的情况，请在选择同步对象前单击右上角的，以确保待选择的对象为最新源数据库对象。
    • 对象名同步到目标库后会转换成小写，因此选择的源库表中不能存在表名称字母相同但大小写不同的表，否则，会导致同步失败。
    • 当对象名称包含空格时，名称前后的空格不显示，中间如有多个空格只显示一个空格。
    • 选择的同步对象名称中不能包含空格。
    • 选择库级同步时，在增量同步过程中，不能在源库创建名称字母相同但大小写不同的表，否则会导致其中一张表无法同步。

  5. 在“数据加工”页面，可对需要加工的表对象进行数据过滤或添加附加列，单击“下一步”。

    • 如果需要设置数据过滤，选择“数据过滤”，设置相关过滤规则。
    • 如果需要设置添加附加列，选择“附加列”，单击“操作”列的“添加”，选填需要添加的列名和操作类型信息。

      相关操作可参考数据加工。

  6. 在“预检查”页面，进行同步任务预校验，校验是否可进行实时同步。

    • 查看检查结果，如有不通过的检查项，需要修复不通过项后，单击“重新校验”按钮重新进行任务预校验。
    • 预检查完成后，且所有检查项结果均通过时，单击“下一步”。

      所有检查项结果均通过时，若存在请确认项，需要阅读并确认详情后才可以继续执行下一步操作。

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

    表12 任务启动设置

    参数

    描述

    启动时间

    同步任务的启动时间可以根据业务需求，设置为“立即启动”或“稍后启动”。

    说明：

    预计同步任务启动后，会对源数据库和目标数据库的性能产生影响，建议选择业务低峰期，合理设置同步任务的启动时间。

  8. 同步任务提交后，您可在“实时同步管理”页面，查看并管理自己的任务。

    • 您可查看任务提交后的状态，状态请参见任务状态说明。
    • 在任务列表的右上角，单击刷新列表，可查看到最新的任务状态。
    • 对于未启动、状态为配置中的任务，DRS默认保留3天，超过3天DRS会自动删除后台资源，当前任务状态不变。当用户再次配置时，DRS会重新申请资源，此时DRS任务IP会发生改变。
    • 对于公网网络类型的任务，由于DRS需要在任务结束后删除后台资源，所以该任务绑定的弹性公网IP需要等待一段时间，才能恢复为解绑状态。

父主题： 入云