全部产品
Search
文档中心

数据传输服务 DTS:PolarDB MySQL版迁移至DataHub

更新时间:Aug 03, 2023

通过数据传输服务DTS(Data Transmission Service),您可以将PolarDB MySQL版迁移至DataHub。

前提条件

  • 已创建目标DataHub项目。具体操作,请参见快速入门
  • 开通DataHub服务,并且创建用作接收迁移数据的项目(Project)。具体操作,请参见快速入门Project操作
  • 目标DataHub项目的存储空间须大于源PolarDB MySQL版集群实例占用的存储空间。

注意事项

说明 DTS不会将源数据库中的外键迁移到目标数据库,因此源数据库的级联、删除等操作不会迁移到目标数据库。
类型说明
源库限制
  • 带宽要求:源库所属的服务器需具备足够出口带宽,否则将影响数据迁移速率。
  • 待迁移的表需具备主键或唯一约束,且字段具有唯一性,否则可能会导致目标数据库中出现重复数据。
  • 若迁移对象为表级别,且需进行编辑(如表列名映射),则单次迁移任务待迁移的表数量超过1000时,建议您拆分待迁移的表,分批配置为多个任务,或者配置整库的迁移任务,否则任务提交后可能会显示请求报错。
  • 如需进行增量迁移,需开启Binlog日志,并且需要将loose_polar_log_bin参数设置为on。否则预检查阶段提示报错,且无法成功启动数据迁移任务。开启Binlog日志和修改参数的方法,请参见开启Binlog修改参数值
    说明
    • PolarDB MySQL版开启Binlog日志会占用一定的存储空间,需要收取存储费用。
    • 如为增量迁移任务,DTS要求源数据库的本地Binlog日志保存24小时以上,否则DTS可能因无法获取Binlog而导致任务失败,极端情况下甚至可能会导致数据不一致或丢失。由于您所设置的Binlog日志保存时间低于DTS要求的时间进而导致的问题,不在DTS的SLA保障范围内。

  • 源库的操作限制:在库表结构迁移阶段,请勿执行库或表结构变更的DDL操作,否则数据迁移任务会失败。
  • 不支持迁移源PolarDB MySQL版只读节点。
其他限制
  • 仅支持增量迁移和库表结构迁移,不支持全量迁移。
  • 仅支持表级别的数据迁移,不支持新增列的数据迁移,即源库中迁移对象表新增了某个列,该列的数据不会迁移至目标DataHub。
  • 全量数据迁移时DTS会占用源和目标库一定读写资源,可能会导致数据库的负载上升。建议在执行数据迁移前评估源库和目标库的性能,同时在业务低峰期执行数据迁移。
  • 对于数据类型为FLOAT或DOUBLE的列,DTS会通过ROUND(COLUMN,PRECISION)来读取这两类列的值。如果没有明确定义其精度,DTS默认对FLOAT的迁移精度为38位,对DOUBLE的迁移精度为308位,请确认迁移精度是否符合业务预期。
  • DTS会尝试恢复七天之内迁移失败实例的任务。因此在业务切换至目标实例前,请务必结束或释放该示例,或者将DTS访问目标实例账号的写权限用REVOKE命令回收掉。避免该任务被自动恢复,导致源端数据覆盖目标实例的数据。
  • 请勿对源库的迁移对象使用pt-online-schema-change等类似工具执行在线DDL变更,否则会导致迁移失败。
其他注意事项DTS会在源库定时执CREATE DATABASE IF NOT EXISTS `test`命令以推进Binlog位点。

费用说明

迁移类型链路配置费用公网流量费用
结构迁移和全量数据迁移不收费。通过公网将数据迁移出阿里云时将收费,详情请参见计费概述
增量数据迁移收费,详情请参见计费概述

迁移类型说明

  • 库表结构迁移

    DTS将源库中迁移对象的结构定义迁移到目标库。

  • 增量迁移

    DTS在全量迁移的基础上,将源库的增量更新数据迁移到目标库中。通过增量数据迁移可以实现在自建应用不停机的情况下,平滑地完成数据迁移。

支持增量迁移的SQL操作

操作类型SQL操作语句
DMLINSERT、UPDATE、DELETE
DDLALTER TABLE、TRUNCATE TABLE

数据库账号的权限要求

数据库权限要求账号创建及授权方法
PolarDB MySQL版集群待迁移对象的读权限创建数据库账号

操作步骤

  1. 进入迁移任务的列表页面。
    1. 登录DMS数据管理服务
    2. 在顶部菜单栏中,单击集成与开发(DTS)
    3. 在左侧导航栏,选择数据传输(DTS) > 数据迁移
    说明
  2. 迁移任务右侧,选择迁移实例所属地域。
    说明 新版DTS迁移任务列表页面,需要在页面左上角选择迁移实例所属地域。
  3. 单击创建任务,配置源库及目标库信息。
    类别配置说明
    任务名称

    DTS会自动生成一个任务名称,建议配置具有业务意义的名称(无唯一性要求),便于后续识别。

    源库信息选择已有的DMS数据库实例

    您可以按实际需求,选择是否使用已有实例。

    • 如使用已有实例,下方数据库信息将自动填入,您无需重复输入。

    • 如不使用已有实例,您需要输入下方的数据库信息。

    数据库类型选择PolarDB for MySQL
    接入方式选择为云实例
    实例地区选择源PolarDB MySQL版实例所属地域。
    是否跨阿里云账号本示例为同一阿里云账号间迁移,选择不跨账号
    PolarDB实例ID选择源PolarDB MySQL版实例ID。
    数据库账号填入源PolarDB MySQL版实例的数据库账号,权限要求,请参见数据库账号的权限要求
    数据库密码

    填入该数据库账号对应的密码。

    目标库信息选择已有的DMS数据库实例

    您可以按实际需求,选择是否使用已有实例。

    • 如使用已有实例,下方数据库信息将自动填入,您无需重复输入。

    • 如不使用已有实例,您需要输入下方的数据库信息。

    数据库类型选择DataHub
    接入方式选择云实例
    实例地区选择目标DataHub项目所属地域。
    Project选择目标DataHub项目ID。
  4. 配置完成后,单击页面下方的测试连接以进行下一步

    如果源或目标数据库是阿里云数据库实例(例如RDS MySQL云数据库MongoDB版等),DTS会自动将对应地区DTS服务的IP地址添加到阿里云数据库实例的白名单;如果源或目标数据库是ECS上的自建数据库,DTS会自动将对应地区DTS服务的IP地址添到ECS的安全规则中,您还需确保自建数据库没有限制ECS的访问;如果源或目标数据库是IDC自建数据库或其他云数据库,则需要您手动添加对应地区DTS服务的IP地址,以允许来自DTS服务器的访问。DTS服务的IP地址,请参见DTS服务器的IP地址段

    警告

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

  5. 配置任务对象及高级配置。
    配置说明
    迁移类型PolarDB MySQL版迁移至DataHub仅支持库表结构迁移增量迁移,您可按照业务需要选择。
    说明 如果未选择增量迁移,为保障数据一致性,数据迁移期间请勿在源实例中写入新的数据。
    目标已存在表的处理模式
    • 预检查并报错拦截:检查目标数据库中是否有同名的表。如果目标数据库中没有同名的表,则通过该检查项目;如果目标数据库中有同名的表,则在预检查阶段提示错误,数据同步任务不会被启动。

      说明 如果目标库中同名的表不方便删除或重命名,您可以更改该表在目标库中的名称,请参见库表列名映射
    • 忽略报错并继续执行:跳过目标数据库中是否有同名表的检查项。
      警告 选择为忽略报错并继续执行,可能导致数据不一致,给业务带来风险,例如:
      • 表结构一致的情况下,如在目标库遇到与源库主键的值相同的记录:
        • 全量期间,DTS会保留目标集群中的该条记录,即源库中的该条记录不会同步至目标数据库中。
        • 增量期间,DTS不会保留目标集群中的该条记录,即源库中的该条记录会覆盖至目标数据库中。
      • 表结构不一致的情况下,可能会导致无法初始化数据、只能同步部分列的数据或同步失败。
    附加列规则DTS在将数据迁移到DataHub时,会在迁移的目标表中添加一些附加列。如果附加列和目标表中已有的列出现名称冲突将会导致数据迁移失败。您需要根据业务需求选择新规则旧规则
    警告 在选择附加列规则前,您需要评估附加列和目标表中已有的列是否会出现名称冲突。关于附加列的规则和定义说明,请参见附加列名称和定义说明
    目标库对象名称大小写策略

    您可以配置目标实例中迁移对象的库名、表名和列名的英文大小写策略。默认情况下选择DTS默认策略,您也可以选择与源库、目标库默认策略保持一致。更多信息,请参见目标库对象名称大小写策略

    源库对象

    源库对象框中选择待迁移对象,然后单击向右小箭头将其移动至已选择对象框。

    说明 迁移对象选择的粒度为库、表。若选择的迁移对象为表,其他对象(如视图、触发器、存储过程)不会被迁移至目标库。
    已选择对象
    • 如需更改单个迁移对象在目标实例中的名称,请右击已选择对象中的迁移对象,设置方式,请参见库表列名单个映射
    • 如需批量更改迁移对象在目标实例中的名称,请单击已选择对象方框右上方的批量编辑,设置方式,请参见库表列名批量映射
    说明
    • 如果使用了对象名映射功能,可能会导致依赖这个对象的其他对象迁移失败。
    • 如需设置WHERE条件过滤数据,请在已选择对象中右击待迁移的表,在弹出的对话框中设置过滤条件。设置方法请参见通过SQL条件过滤任务数据
    • 如需按库或表级别选择迁移的SQL操作,请在已选择对象中右击待迁移对象,并在弹出的对话框中选择所需迁移的SQL操作。支持的操作请参见支持增量迁移的SQL操作
  6. 单击下一步高级配置
    配置说明
    设置告警

    是否设置告警,当迁移失败或延迟超过阈值后,将通知告警联系人。

    配置ETL功能
    选择是否配置ETL功能。关于ETL的更多信息,请参见什么是ETL
    是否去除正反向任务的心跳表sql

    根据业务需求选择是否在DTS实例运行时,在源库中写入心跳SQL信息。

    • :不在源库中写入心跳SQL信息,DTS实例可能会显示有延迟。

    • :在源库中写入心跳SQL信息,可能会影响源库的物理备份和克隆等功能。

  7. 上述配置完成后,单击页面下方的下一步保存任务并预检查

    您可以将鼠标光标移动至下一步保存任务并预检查按钮上,然后单击气泡中的预览OpenAPI调用,查看调用API接口配置该实例时的参数信息。

    说明
    • 在迁移任务正式启动之前,会先进行预检查。只有预检查通过后,才能成功启动迁移任务。

    • 如果预检查失败,请单击失败检查项后的查看详情,并根据提示修复后重新进行预检查。

    • 如果预检查产生警告:

      • 对于不可以忽略的检查项,请单击失败检查项后的查看详情,并根据提示修复后重新进行预检查。

      • 对于可以忽略无需修复的检查项,您可以依次单击点击确认告警详情确认屏蔽确定重新进行预检查,跳过告警检查项重新进行预检查。如果选择屏蔽告警检查项,可能会导致数据不一致等问题,给业务带来风险。

  8. 预检查通过率显示为100%时,单击下一步购买

  9. 购买页面,选择数据迁移实例的链路规格,详细说明请参见下表。

    类别

    参数

    说明

    信息配置

    资源组配置

    选择实例所属的资源组,默认为default resource group。更多信息,请参见什么是资源管理

    链路规格

    DTS为您提供了不同性能的迁移规格,迁移链路规格的不同会影响迁移速率,您可以根据业务场景进行选择。更多信息,请参见数据迁移链路规格说明

  10. 配置完成后,阅读并选中《数据传输(按量付费)服务条款》

  11. 单击购买并启动,迁移任务正式开始,您可在数据迁移界面查看具体进度。