本文为 TiDB Data Migration 源码阅读系列文章的第四篇，《DM 源码阅读系列文章（三）数据同步处理单元介绍》介绍了数据同步处理单元实现的功能，数据同步流程的运行逻辑以及数据同步处理单元的 interface 设计。本篇文章在此基础上展开，详细介绍 dump 和 load 两个数据同步处理单元的设计实现，重点关注数据同步处理单元 interface 的实现，数据导入并发模型的设计，以及导入任务在暂停或出现异常后如何恢复。
dump 处理单元
dump 处理单元的代码位于github.com/pingcap/dm/mydumper包内，作用是从上游 MySQL 将表结构和数据导出到逻辑 SQL 文件，由于该处理单元总是运行在任务的第一个阶段（full 模式和 all 模式），该处理单元每次运行不依赖于其他处理单元的处理结果。另一方面，如果在 dump 运行过程中被强制终止（例如在 dmctl 中执行 pause-task 或者 stop-task），也不会记录已经 dump 数据的 checkpoint 等信息。不记录 checkpoint 是因为每次运行 Mydumper 从上游导出数据，上游的数据都可能发生变更，为了能得到一致的数据和 metadata 信息，每次恢复任务或重新运行任务时该处理单元会清理旧的数据目录，重新开始一次完整的数据 dump。
导出表结构和数据的逻辑并不是在 DM 内部直接实现，而是通过os/exec包调用外部 mydumper 二进制文件来完成。在 Mydumper 内部，我们需要关注以下几个问题：
数据导出时的并发模型是如何实现的。
no-locks, lock-all-tables, less-locking 等参数有怎样的功能。
库表黑白名单的实现方式。
Mydumper 的实现细节
Mydumper的一次完整的运行流程从主线程开始,主线程按照以下步骤执行:
解析参数。
会根据
no-locks选项进行一系列的备份安全策略，包括long query guard和lock all tables or FLUSH TABLES WITH READ LOCK。如果配置了
trx-consistency-only选项，执行UNLOCK TABLES /* trx-only */释放之前获取的表锁。注意，如果开启该选项，是无法保证非 InnoDB 表导出数据的一致性。更多关于一致性读的细节可以参考MySQL 官方文档 Consistent Nonlocking Reads 部分。如果没有配置
no-locks和trx-consistency-only选项，执行 UNLOCK TABLES /* FTWRL */ 释放锁。
工作线程的并发控制包括了两个层面，一层是在不同表级别的并发，另一层是同一张表级别的并发。Mydumper 的主线程会将一次同步任务拆分为多个同步子任务，并将每个子任务分发给同一个异步队列conf.queue_less_locking/conf.queue，工作子线程从队列中获取任务并执行。具体的子任务划分包括以下策略：
开启
less-locking选项的非 InnoDB 表的处理。- 先将所有
non_innodb_table分为num_threads组，分组方式是遍历这些表，依此将遍历到的表加入到当前数据量最小的分组，尽量保证每个分组内的数据量相近。 - 上述得到的每个分组内会包含一个或多个非 InnoDB 表，如果配置了
rows-per-file选项，会对每张表进行chunks估算，对于每一张表，如果估算结果包含多个 chunks，会将子任务进一步按照chunks进行拆分，分发chunks数量个子任务，如果没有chunks划分，分发为一个独立的子任务。 - 注意，在该模式下，子任务会发送到
queue_less_locking，并在编号为num_threads~ 2 *num_threads的子线程中处理任务。less_locking_threads任务执行完成之后，主线程就会 UNLOCK TABLES /* FTWRL */ 释放锁，这样有助于减少锁持有的时间。主线程根据conf.unlock_tables来判断非 InnoDB 表是否全部导出，普通工作线程或者queue_less_locking工作线程每次处理完一个非 InnoDB 表任务都会根据non_innodb_table_counter和non_innodb_done两个变量判断是否还有没有导出结束的非 InnoDB 表，如果都已经导出结束，就会向异步队列conf.unlock_tables中发送一条数据，表示可以解锁全局锁。- 每个
less_locking_threads处理非 InnoDB 表任务时，会先加表锁，导出数据，最后解锁表锁。
- 先将所有
未开启
less-locking选项的非 InnoDB 表的处理。InnoDB 表的处理。
- 与未开启
less-locking选项的非 InnoDB 表的处理相同，同样是按照表分发子任务，如果有chunks子任务会进一步细分。
- 与未开启
从上述的并发模型可以看出 Mydumper 首先按照表进行同步任务拆分，对于同一张表，如果配置rows-per-file参数，会根据该参数和表行数将表划分为合适的chunks数，这即是同一张表内部的并发。具体表行数的估算和chunks划分的实现见get_chunks_for_table函数。
需要注意目前 DM 在任务配置中指定的库表黑白名单功能只应用于 load 和 binlog replication 处理单元。如果在 dump 处理单元内使用库表黑白名单功能，需要在同步任务配置文件的 dump 处理单元配置提供 extra-args 参数，并指定 Mydumper 相关参数，包括 --database, --tables-list 和 --regex。Mydumper 使用 regex 过滤库表的实现参考check_regex函数。
load 处理单元
load 处理单元的代码位于github.com/pingcap/dm/loader包内，该处理单元在 dump 处理单元运行结束后运行，读取 dump 处理单元导出的 SQL 文件解析并在下游数据库执行逻辑 SQL。我们重点分析Init和Process两个 interface 的实现。
Init 实现细节
该阶段进行一些初始化和清理操作，并不会开始同步任务，如果在该阶段运行中出现错误，会通过rollback 机制清理资源，不需要调用 Close 函数。该阶段包含的初始化操作包括以下几点：
创建
checkpoint，checkpoint用于记录全量数据的导入进度和 load 处理单元暂停或异常终止后，恢复或重新开始任务时可以从断点处继续导入数据。应用任务配置的数据同步规则，包括以下规则：
Process 实现细节
该阶段的工作流程也很直观，通过一个收发数据类型为*pb.ProcessError的channel接收运行过程中出现的错误，出错后通过 context 的CancelFunc强制结束处理单元运行。在核心的数据导入函数中，工作模型与 mydumper 类似，即在主线程中分发任务，有多个工作线程执行具体的数据导入任务。具体的工作细节如下：
主线程会按照库，表的顺序读取创建库语句文件
-schema-create.sql . -schema-create.sql 主线程读取
checkpoint信息，结合数据文件信息创建 fileJob 随机分发任务给一个工作子线程，fileJob 任务的结构如下所示 ：typefileJobstruct{ schemastringtablestringdataFilestringoffsetint64// 表示读取文件的起始 offset，如果没有 checkpoint 断点信息该值为 0info *tableInfo// 保存原库表，目标库表，列名，insert 语句 column 名字列表等信息}在每个工作线程内部，有一个循环不断从自己
fileJobQueue获取任务，每次获取任务后会对文件进行解析，并将解析后的结果分批次打包为 SQL 语句分发给线程内部的另外一个工作协程，该工作协程负责处理 SQL 语句的执行。工作流程的伪代码如下所示，完整的代码参考func (w *Worker) run()：// worker 工作线程内分发给内部工作协程的任务结构typedataJobstruct{ sqlstring// insert 语句, insert intovalues (x, y, z), (x2, y2, z2), … (xn, yn, zn);schemastring// 目标数据库filestring// SQL 文件名offsetint64// 本次导入数据在 SQL 文件的偏移量lastOffsetint64// 上一次已导入数据对应 SQL 文件偏移量}// SQL 语句执行协程doJob :=func(){for{select{case<-ctx.Done():returncasejob := <-jobQueue: sqls := []string{ fmt.Sprintf("USE `%s`;", job.schema),// 指定插入数据的 schemajob.sql, checkpoint.GenSQL(job.file, job.offset),// 更新 checkpoint 的 SQL 语句} executeSQLInOneTransaction(sqls)// 在一个事务中执行上述 3 条 SQL 语句} } }// worker 主线程for{select{case<-ctx.Done():returncasejob := <-fileJobQueue:godoJob() readDataFileAndDispatchSQLJobs(ctx, dir, job.dataFile, job.offset, job.info) } }
dispatchSQL函数负责在工作线程内部读取 SQL 文件和重写 SQL，该函数会在运行初始阶段创建所操作表的checkpoint信息，需要注意在任务中断恢复之后，如果这个文件的导入还没有完成，checkpoint.Init仍然会执行，但是这次运行不会更新该文件的checkpoint信息。列值转换和库表路由也是在这个阶段内完成。列值转换：需要对输入 SQL 进行解析拆分为每一个 field，对需要转换的 field 进行转换操作，然后重新拼接起 SQL 语句。详细重写流程见reassemble函数。
库表路由：这种场景下只需要替换源表到目标表即可。
在工作线程执行一个批次的 SQL 语句之前，会首先根据文件
offset信息生成一条更新 checkpoint 的语句，加入到打包的 SQL 语句中，具体执行时这些语句会在一个事务中提交，这样就保证了断点信息的准确性，如果导入过程暂停或中断，恢复任务后从断点重新同步可以保证数据一致。小结
本篇详细介绍转储和 load 两个数据同步处理单元的设计实现，对核心 interface 实现、数据导入并发模型、数据导入暂停或中断的恢复进行了分析。接下来的文章会继续介绍
binlog replication，relay log两个数据同步处理单元的实现。点击查看更多DM 源码阅读系列文章
京公网安备 11010802035112 号