数据迁移任务配置向导

本文档介绍如何配置 Data Migration (DM) 的数据迁移任务。

配置需要迁移的数据源

配置需要迁移的数据源之前,首先应该确认已经在 DM 创建相应数据源:

仿照下面的 mysql-instances: 示例定义数据迁移任务需要同步的单个或者多个数据源。

  1. ## ********* 任务信息配置 *********
  2. name: test # 任务名称,需要全局唯一
  3. ## ******** 数据源配置 **********
  4. mysql-instances:
  5. - source-id: "mysql-replica-01" # 从 source-id = mysql-replica-01 的数据源迁移数据
  6. - source-id: "mysql-replica-02" # 从 source-id = mysql-replica-02 的数据源迁移数据

配置迁移的目标 TiDB 集群

仿照下面的 target-database: 示例定义迁移的目标 TiDB 集群。

  1. ## ********* 任务信息配置 *********
  2. name: test # 任务名称,需要全局唯一
  3. ## ******** 数据源配置 **********
  4. mysql-instances:
  5. - source-id: "mysql-replica-01" # 从 source-id = mysql-replica-01 的数据源迁移数据
  6. - source-id: "mysql-replica-02" # 从 source-id = mysql-replica-02 的数据源迁移数据
  7. ## ******** 目标 TiDB 配置 **********
  8. target-database: # 目标 TiDB 配置
  9. host: "127.0.0.1"
  10. port: 4000
  11. user: "root"
  12. password: "" # 如果密码不为空,则推荐使用经过 dmctl 加密的密文

配置需要迁移的表

如果不需要过滤或迁移特定表,可以跳过该项配置。

配置从数据源迁移表的黑白名单,则需要添加两个定义,详细配置规则参考 Block & Allow Lists

  1. 定义全局的黑白名单规则

    1. block-allow-list:
    2. bw-rule-1: # 规则名称
    3. do-dbs: ["test.*", "user"] # 迁移哪些库,支持通配符 "*" 和 "?",do-dbs 和 ignore-dbs 只需要配置一个,如果两者同时配置只有 do-dbs 会生效
    4. # ignore-dbs: ["mysql", "account"] # 忽略哪些库,支持通配符 "*" 和 "?"
    5. do-tables: # 迁移哪些表,do-tables 和 ignore-tables 只需要配置一个,如果两者同时配置只有 do-tables 会生效
    6. - db-name: "test.*"
    7. tbl-name: "t.*"
    8. - db-name: "user"
    9. tbl-name: "information"
    10. bw-rule-2: # 规则名称
    11. ignore-tables: # 忽略哪些表
    12. - db-name: "user"
    13. tbl-name: "log"
  2. 在数据源配置中引用黑白名单规则,过滤该数据源需要迁移的表

    1. mysql-instances:
    2. - source-id: "mysql-replica-01" # 从 source-id = mysql-replica-01 的数据源迁移数据
    3. block-allow-list: "bw-rule-1" # 黑白名单配置名称,如果 DM 版本早于 v2.0.0-beta.2 则使用 black-white-list
    4. - source-id: "mysql-replica-02" # 从 source-id = mysql-replica-02 的数据源迁移数据
    5. block-allow-list: "bw-rule-2" # 黑白名单配置名称,如果 DM 版本早于 v2.0.0-beta.2 则使用 black-white-list

配置需要过滤的操作

如果不需要过滤特定库或者特定表的特定操作,可以跳过该项配置。

配置过滤特定操作,则需要添加两个定义,详细配置规则参考 Binlog Event Filter

  1. 定义全局的数据源操作过滤规则

    1. filters: # 定义过滤数据源特定操作的规则,可以定义多个规则
    2. filter-rule-1: # 规则名称
    3. schema-pattern: "test_*" # 匹配数据源的库名,支持通配符 "*" 和 "?"
    4. table-pattern: "t_*" # 匹配数据源的表名,支持通配符 "*" 和 "?"
    5. events: ["truncate table", "drop table"] # 匹配上 schema-pattern 和 table-pattern 的库或者表的操作类型
    6. action: Ignore # 迁移(Do)还是忽略(Ignore)
    7. filter-rule-2:
    8. schema-pattern: "test"
    9. events: ["all dml"]
    10. action: Do
  2. 在数据源配置中引用数据源操作过滤规则,过滤该数据源的指定库或表的指定操作

    1. mysql-instances:
    2. - source-id: "mysql-replica-01" # 从 source-id = mysql-replica-01 的数据源迁移数据
    3. block-allow-list: "bw-rule-1" # 黑白名单配置名称,如果 DM 版本早于 v2.0.0-beta.2 则使用 black-white-list
    4. filter-rules: ["filter-rule-1"] # 过滤数据源特定操作的规则,可以配置多个过滤规则
    5. - source-id: "mysql-replica-02" # 从 source-id = mysql-replica-02 的数据源迁移数据
    6. block-allow-list: "bw-rule-2" # 黑白名单配置名称,如果 DM 版本早于 v2.0.0-beta.2 则使用 black-white-list
    7. filter-rules: ["filter-rule-2"] # 过滤数据源特定操作的规则,可以配置多个过滤规则

配置需要数据源表到目标 TiDB 表的映射

如果不需要将数据源表路由到不同名的目标 TiDB 表,可以跳过该项配置。分库分表合并迁移的场景必须配置该规则。

配置数据源表迁移到目标 TiDB 表的路由规则,则需要添加两个定义,详细配置规则参考 Table Routing

  1. 定义全局的路由规则

    1. routes: # 定义数据源表迁移到目标 TiDB 表的路由规则,可以定义多个规则
    2. route-rule-1: # 规则名称
    3. schema-pattern: "test_*" # 匹配数据源的库名,支持通配符 "*" 和 "?"
    4. table-pattern: "t_*" # 匹配数据源的表名,支持通配符 "*" 和 "?"
    5. target-schema: "test" # 目标 TiDB 库名
    6. target-table: "t" # 目标 TiDB 表名
    7. route-rule-2:
    8. schema-pattern: "test_*"
    9. target-schema: "test"
  2. 在数据源配置中引用路由规则,过滤该数据源需要迁移的表

    1. mysql-instances:
    2. - source-id: "mysql-replica-01" # 从 source-id = mysql-replica-01 的数据源迁移数据
    3. block-allow-list: "bw-rule-1" # 黑白名单配置名称,如果 DM 版本早于 v2.0.0-beta.2 则使用 black-white-list
    4. filter-rules: ["filter-rule-1"] # 过滤数据源特定操作的规则,可以配置多个过滤规则
    5. route-rules: ["route-rule-1", "route-rule-2"] # 数据源表迁移到目标 TiDB 表的路由规则,可以定义多个规则
    6. - source-id: "mysql-replica-02" # 从 source-id = mysql-replica-02 的数据源迁移数据
    7. block-allow-list: "bw-rule-2" # 黑白名单配置名称,如果 DM 版本早于 v2.0.0-beta.2 则使用 black-white-list
    8. filter-rules: ["filter-rule-2"] # 过滤数据源特定操作的规则,可以配置多个过滤规则

配置是否进行分库分表合并

如果是分库分表合并的数据迁移场景,并且需要同步分库分表的 DDL,则必须显式配置 shard-mode,否则不要配置该选项。

分库分表 DDL 同步问题特别多,请确认了解 DM 同步分库分表 DDL 的原理和限制后,谨慎使用。

  1. ## ********* 任务信息配置 *********
  2. name: test # 任务名称,需要全局唯一
  3. shard-mode: "pessimistic" # 如果为分库分表合并任务则需要配置该项。默认使用悲观协调模式 "pessimistic",在深入了解乐观协调模式的原理和使用限制后,也可以设置为乐观协调模式 "optimistic"

其他配置

下面是本数据迁移任务配置向导的完整示例。完整的任务配置参见 DM 任务完整配置文件介绍,其他各配置项的功能和配置也可参阅数据迁移功能

  1. ## ********* 任务信息配置 *********
  2. name: test # 任务名称,需要全局唯一
  3. shard-mode: "pessimistic" # 如果为分库分表合并任务则需要配置该项。默认使用悲观协调模式 "pessimistic",在深入了解乐观协调模式的原理和使用限制后,也可以设置为乐观协调模式 "optimistic"
  4. task-mode: all # 任务模式,可设为 "full" - "只进行全量数据迁移"、"incremental" - "Binlog 实时同步"、"all" - "全量 + Binlog 迁移"
  5. ## ******** 数据源配置 **********
  6. mysql-instances:
  7. - source-id: "mysql-replica-01" # 从 source-id = mysql-replica-01 的数据源迁移数据
  8. block-allow-list: "bw-rule-1" # 黑白名单配置名称,如果 DM 版本早于 v2.0.0-beta.2 则使用 black-white-list
  9. filter-rules: ["filter-rule-1"] # 过滤数据源特定操作的规则,可以配置多个过滤规则
  10. route-rules: ["route-rule-1", "route-rule-2"] # 数据源表迁移到目标 TiDB 表的路由规则,可以定义多个规则
  11. - source-id: "mysql-replica-02" # 从 source-id = mysql-replica-02 的数据源迁移数据
  12. block-allow-list: "bw-rule-2" # 黑白名单配置名称,如果 DM 版本早于 v2.0.0-beta.2 则使用 black-white-list
  13. filter-rules: ["filter-rule-2"] # 过滤数据源特定操作的规则,可以配置多个过滤规则
  14. route-rules: ["route-rule-2"] # 数据源表迁移到目标 TiDB 表的路由规则,可以定义多个规则
  15. ## ******** 目标 TiDB 配置 **********
  16. target-database: # 目标 TiDB 配置
  17. host: "127.0.0.1"
  18. port: 4000
  19. user: "root"
  20. password: "" # 如果密码不为空,则推荐使用经过 dmctl 加密的密文
  21. ## ******** 功能配置 **********
  22. block-allow-list: # 定义数据源迁移表的过滤规则,可以定义多个规则。如果 DM 版本早于 v2.0.0-beta.2 则使用 black-white-list
  23. bw-rule-1: # 规则名称
  24. do-dbs: ["test.*", "user"] # 迁移哪些库,支持通配符 "*" 和 "?",do-dbs 和 ignore-dbs 只需要配置一个,如果两者同时配置只有 do-dbs 会生效
  25. # ignore-dbs: ["mysql", "account"] # 忽略哪些库,支持通配符 "*" 和 "?"
  26. do-tables: # 迁移哪些表,do-tables 和 ignore-tables 只需要配置一个,如果两者同时配置只有 do-tables 会生效
  27. - db-name: "test.*"
  28. tbl-name: "t.*"
  29. - db-name: "user"
  30. tbl-name: "information"
  31. bw-rule-2: # 规则名称
  32. ignore-tables: # 忽略哪些表
  33. - db-name: "user"
  34. tbl-name: "log"
  35. filters: # 定义过滤数据源特定操作的规则,可以定义多个规则
  36. filter-rule-1: # 规则名称
  37. schema-pattern: "test_*" # 匹配数据源的库名,支持通配符 "*" 和 "?"
  38. table-pattern: "t_*" # 匹配数据源的表名,支持通配符 "*" 和 "?"
  39. events: ["truncate table", "drop table"] # 匹配上 schema-pattern 和 table-pattern 的库或者表的操作类型
  40. action: Ignore # 迁移(Do)还是忽略(Ignore)
  41. filter-rule-2:
  42. schema-pattern: "test"
  43. events: ["all dml"]
  44. action: Do
  45. routes: # 定义数据源表迁移到目标 TiDB 表的路由规则,可以定义多个规则
  46. route-rule-1: # 规则名称
  47. schema-pattern: "test_*" # 匹配数据源的库名,支持通配符 "*" 和 "?"
  48. table-pattern: "t_*" # 匹配数据源的表名,支持通配符 "*" 和 "?"
  49. target-schema: "test" # 目标 TiDB 库名
  50. target-table: "t" # 目标 TiDB 表名
  51. route-rule-2:
  52. schema-pattern: "test_*"
  53. target-schema: "test"