ITPub博客

首页 > 数据库 > > DM 任务配置文件介绍

DM 任务配置文件介绍

作者:浪花小雨滴 时间:2020-05-15 15:21:16 0 删除 编辑

本文档主要介绍 Data Migration (DM) 的任务基础配置文件 task_basic.yaml,包含实例配置两部分。

完整的任务配置参见 数据同步功能。

关键概念

关于包括 source-id 和 DM-worker ID 在内的关键概念的介绍,请参阅基础配置文件示例

下面是一个基础的配置文件示例,通过该示例可以完成简单的数据同步功能。

---

# ----------- 全局配置 -----------
## ********* 基本信息配置 *********
name: test             # 任务名称,需要全局唯一
task-mode: all         # 任务模式,可设为 "full"、"incremental"、"all"

target-database:       # 下游数据库实例配置
  host: "127.0.0.1"
  port: 4000
  user: "root"
  password: ""         # 如果不为空则需经过 dmctl 加密

## ******** 功能配置集 **********
black-white-list:        # 上游数据库实例匹配的表的 black & white list 过滤规则集
  bw-rule-1:             # 黑白名单配置的名称
    do-dbs: ["all_mode"] # 同步哪些库

# ----------- 实例配置 -----------
mysql-instances:
  - source-id: "mysql-replica-01"  # 上游实例或者复制组 ID,参考 `dm-master.toml` 的 `source-id` 配置
    black-white-list:  "bw-rule-1" # 黑白名单配置名称
    mydumper-thread: 4             # mydumper 用于导出数据的线程数量,在 v1.0.2 版本引入
    loader-thread: 16              # loader 用于导入数据的线程数量,在 v1.0.2 版本引入
    syncer-thread: 16              # syncer 用于同步增量数据的线程数量,在 v1.0.2 版本引入

  - source-id: "mysql-replica-02" # 上游实例或者复制组 ID,参考 `dm-master.toml` 的 `source-id` 配置
    black-white-list:  "bw-rule-1" # 黑白名单配置名称
    mydumper-thread: 4             # mydumper 用于导出数据的线程数量,在 v1.0.2 版本引入
    loader-thread: 16              # loader 用于导入数据的线程数量,在 v1.0.2 版本引入
    syncer-thread: 16              # syncer 用于同步增量数据的线程数量,在 v1.0.2 版本引入

配置顺序

通过上面的配置文件示例,可以看出配置文件总共分为两个部分:全局配置和实例配置,其中全局配置又分为基础信息配置和功能配置集,配置顺序如下:

  1. 编辑根据全局配置编辑全局配置

    任务基本信息配置

    配置任务的基本信息,配置项的说明参见以上示例配置文件中的注释。关于 task-mode 的特殊说明如下:

    • 描述:任务模式,可以通过任务模式来指定需要执行的数据迁移工作。
    • 值为字符串(full,incremental 或 all)。
      • full:只全量备份上游数据库,然后将数据全量导入到下游数据库。
      • incremental:只通过 binlog 把上游数据库的增量修改同步到下游数据库, 可以设置实例配置的 meta 配置项来指定增量同步开始的位置。
      • all:full + incremental。先全量备份上游数据库,将数据全量导入到下游数据库,然后从全量数据备份时导出的位置信息 (binlog position) 开始通过 binlog 增量同步数据到下游数据库。

    功能配置集

    对于一般的业务场景,只需要配置黑白名单过滤规则集,配置说明参见以上示例配置文件中 black-white-list 的注释以及 实例配置

    本小节定义具体的数据同步子任务,DM 支持从单个或者多个上游 MySQL 实例同步数据到同一个下游数据库实例。 配置项说明参见以上示例配置文件中 mysql-instances 的注释。

    修改任务配置

    在某些情况下需要更新任务配置内容,比如重置数据同步任务时设置了 remove-meta 为 true 和 task-mode 为 all,当数据同步任务重置完成后,需要更新任务配置文件中的 remove-meta 设置为 false,防止下一次启动任务的时候重新同步任务。

    因为 DM 集群会持久化保存任务配置,所以修改任务配置需要通过 stop-task、start-task 将修改后的配置更新到 DM 集群中,如果直接修改任务配置文件,但是不重启任务,配置变更不会生效,DM 集群重启时仍然会读取之前保存的任务配置。

    这里以修改 remove-meta 配置为例,举例说明任务配置修改步骤:

    1. 修改任务配置文件,将 remove-meta 设置为 false

    2. 通过 stop-task 命令停止任务:stop-task <task-name>

    3. 通过 start-task 命令启动任务:start-task <config-file>

来自 “ ITPUB博客 ” ,链接:https://blog.itpub.net/31537575/viewspace-3151632/ ,如需转载,请注明出处,否则将追究法律责任。

下一篇: DM 版本升级
请登录后发表评论 登录
全部评论

注册时间:2018-05-16

  • 博文量
    4259
  • 访问量
    39893