大网数据广告活动
数据库部署与 SQL 参考

暂停 TiDB Data Migration 数据迁移任务

· 52CE 我爱测

# 暂停 TiDB Data Migration 数据迁移任务 命令用于暂停数据迁移任务。 > **注意:** > > 有关 与 的区别如下: > > - 使用 仅暂停迁移任务的执行,但仍然会在内存中保留任务的状态信息等,且可通过 进行查询;使用 会停止迁移任务的执行,并移除内存中与该任务相关的信息,且不可再通过 进行查询,但不会移除已经写入到下游数据库中的数据以及其中的 checkpoint 等 信息。 > - 使用 暂停迁移任务期间

暂停 TiDB Data Migration 数据迁移任务

pause-task 命令用于暂停数据迁移任务。

注意:

有关 pause-task 与 stop-task 的区别如下:

  • 使用 pause-task 仅暂停迁移任务的执行,但仍然会在内存中保留任务的状态信息等,且可通过 query-status 进行查询;使用 stop-task 会停止迁移任务的执行,并移除内存中与该任务相关的信息,且不可再通过 query-status 进行查询,但不会移除已经写入到下游数据库中的数据以及其中的 checkpoint 等 dm_meta 信息。
  • 使用 pause-task 暂停迁移任务期间,由于任务本身仍然存在,因此不能再启动同名的新任务,且会阻止对该任务所需 relay log 的清理;使用 stop-task 停止任务后,由于任务不再存在,因此可以再启动同名的新任务,且不会阻止对 relay log 的清理。
  • pause-task 一般用于临时暂停迁移任务以排查问题等;stop-task 一般用于永久删除迁移任务或通过与 start-task 配合以更新配置信息。
help pause-task
pause a specified running task

Usage:
 dmctl pause-task [-s source ...] <task-name | task-file> [flags]

Flags:
 -h, --help   help for pause-task

Global Flags:
 -s, --source strings   MySQL Source ID

命令用法示例

pause-task [-s "mysql-replica-01"] task-name

参数解释

  • -s:
    • 可选
    • 指定在特定的一个 MySQL 源上暂停数据迁移任务的子任务
    • 如果设置,则只暂停该任务在指定 MySQL 源上的子任务
  • task-name| task-file:
    • 必选
    • 指定任务名称或任务文件路径

返回结果示例

pause-task test
{
    "op": "Pause",
    "result": true,
    "msg": "",
    "sources": [
        {
            "result": true,
            "msg": "",
            "source": "mysql-replica-01",
            "worker": "worker1"
        }
    ]
}

本文来自 PingCAP / TiDB 文档贡献者,按 CC BY-SA 3.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
PingCAP / TiDB 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY-SA 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。