版本:v4.24
重置为未激活
适用场景
任务已经运行过,但需要保留原任务 ID、映射和权限关系,以新的同步起点或调整后的任务配置重新执行同步时,可使用“重置为未激活”。例如,外部系统长期引用同一任务 ID,实施人员需要重新初始化同步,又不希望重新创建任务及其关联配置。
此功能针对单个已暂停或已完成的任务。重置是一次新的运行准备,不是“从上次位点继续运行”;是否重新全量读取、从指定位置读取,以及目标表旧数据如何处理,仍取决于重新激活前选定的同步起点和现有写入策略。
功能说明
重置保留任务 ID、名称、所属项目、配置、映射及权限关系,清理上一轮运行使用的位点、缓存、错误队列、运行实例和监控统计。成功后,原任务回到未激活状态,原先因激活而锁定的配置按未激活任务规则重新开放编辑。
该操作会删除任务的内部运行数据,不能撤销。它不会清空或回滚源端、目的端业务数据,也不会在完成后自动激活任务。任务 ID 不变,适合外部系统持续通过原任务 ID 调用 DataPipeline API 的场景。
适用状态与权限
具备任务编辑权限的用户,可对已暂停或已完成的任务发起重置。任务运行中、等待资源、故障或处于其他过渡状态时,应先按正常流程暂停并确认状态,再执行重置。未激活任务无需重复重置。
重置中不能激活、暂停、删除、复制或修改配置。重置失败时可查看日志、排除故障后重试重置,也可按产品允许的操作复制或删除任务;未完成清理前不能激活该任务。
页面操作
- 打开数据任务详情,确认任务 ID、名称、映射、目标端业务数据及当前同步起点。需要保留上一轮监控数据时,应在重置前另行留存,因为重置会清空任务历史统计与图表。
- 将运行中的任务正常暂停,等待状态变为「已暂停」;已完成任务可直接进入下一步。
- 点击「重置为未激活」。确认框会询问“是否重置该数据任务?”,并提示重置将清空同步位点、运行缓存、错误队列和历史统计。核对任务后点击「确认」;点击「取消」则不提交重置。
- 等待任务从「重置中」变为「未激活」。重置是异步操作,不要仅凭提交成功提示判断清理完成;出现「重置失败」时查看任务日志中的失败阶段和原因,排除故障后使用「重试重置」。失败时已完成的部分清理不会自动回滚。
- 重置成功后,任务详情按未激活规则显示基本配置,旧监控页不再展示。按新一轮同步需要检查并修改任务配置、映射、同步方式、起点及目标端写入策略,然后手动激活。重新运行后核对源端与目标端数据、任务进度和错误队列。
重置后的数据与配置
| 对象 | 处理结果 |
|---|---|
| 任务身份与业务定义 | 保留任务 ID、名称、链路、基本/策略/限制配置、映射及映射 ID、项目和权限。 |
| 审计日志 | 保留既有操作记录,并新增本次重置的发起、成功或失败日志。 |
| 运行资源与进度 | 清理本任务的 Source/Sink 实例、内部消息资源、消费进度、源/目的端运行位点、运行缓存及相关 CDC 资源。共享资源和其他任务的数据不应被删除。 |
| 错误队列与监控 | 清空本任务错误队列及运行统计、历史图表;重新激活后从新一轮运行重新计数。 |
| 源端与目的端业务数据 | 不因重置自动删除、清空或回滚。 |