您可以通过自然语言指令驱动Qoder、CodeX等代码Agent,重跑Dataphin调度任务实例,支持单实例或批量重跑,也支持以根实例为起点联动重跑整条下游链路。本文为您介绍该能力的功能、使用前提、使用示例与执行结果,并在附录中提供输入信息清单供参考。
功能介绍
重跑任务实例能力支持您通过自然语言指令,对Dataphin调度任务实例触发重新执行,常见包括按任务名与业务日期定位实例后重跑单个或批量实例,以及以某个根实例为起点联动重跑该实例及其所有下游节点(修复整条数据链路),重跑后还可查看实例最新状态与运行日志。
适用场景:
-
周期实例失败、等待调度超时或被暂停后,需要手动触发重新执行。
-
批量重跑某个业务日期下的多个失败实例。
-
以根实例为起点联动重跑整条下游链路,修复链路数据。
-
只重跑下游链路中的失败实例。
能力限制:重跑不等于修复,若任务配置或源数据本身有问题,重跑仍会失败,需结合日志诊断;单实例重跑后实例状态会随之变化,而重跑下游链路不创建新实例、只在原实例下新增运行记录,两者的验证方式不同;匹配到多条实例时须确认唯一目标,不会直接全部重跑。
使用前提
-
已知目标租户ID与项目ID。
-
已知目标任务名称与业务日期(默认T-1,即昨天)。
-
目标实例已存在,例如失败、超时或被暂停。
-
重跑下游链路时,需明确根实例与下游范围。
使用示例
您可以直接用自然语言向Agent描述需求,以下为可直接复制的指令示例:
-
重跑某个任务昨天(业务日期)失败的实例。
-
批量重跑某个业务日期下的多个失败实例。
-
以某个根实例为起点,联动重跑它及其所有下游节点。
-
只重跑下游链路中的失败实例。
-
重跑后查看实例的最新状态。
-
重跑仍失败时拉取运行日志排查原因。
交互步骤:
-
Agent通常会先与您确认目标项目、任务名称、业务日期(默认T-1,即昨天)与环境(开发或生产)。
-
Agent通常会先定位目标实例,同名任务可能跨多个项目,若匹配到多条会向您展示并确认唯一目标。
-
执行重跑前,Agent通常会与您确认实例、任务名、项目、环境与业务日期;重跑下游链路时还会确认根实例、下游范围与是否包含根实例。
-
单实例重跑后,Agent通常会查询实例状态确认是否由失败转为运行中乃至成功,仍失败时拉取日志定位根因。
-
重跑下游链路不创建新实例,Agent通常会通过实例的运行日志确认是否新增了运行记录并成功。
执行结果
操作完成后,您可以获得以下结果:
-
返回内容:重跑返回运维指令是否下发成功,实例状态查询返回最新状态与起止时间、耗时,日志查询返回各次运行记录与日志内容。
-
完成状态:指令下发成功不等于实例最终成功;单实例重跑以实例状态由失败转为成功为准,重跑下游链路以各实例新增运行记录且状态成功为准。
-
查看与验证:可通过实例状态与运行日志核对重跑结果;若仍失败,可结合日志排查数据源权限、目标表或字段不存在、资源排队等常见原因。
命令行返回成功仅表示请求已受理,最终请以Dataphin界面显示的实际结果为准。
附录:输入信息
以下为重跑任务实例时可能涉及的信息项,仅供参考。实际使用时,Agent会根据您的指令自动识别所需信息,缺失时再向您询问;标注为无需提供的信息项由系统自动生成,您无需准备。
|
信息项 |
是否必填 |
说明 |
示例 |
|
租户ID |
条件必填 |
已在凭证配置中指定时可省略。 |
1234567890123456789 |
|
项目ID |
是 |
实例所属项目。 |
—— |
|
环境 |
否 |
开发或生产,默认生产。 |
生产 |
|
任务名称 |
是 |
要重跑的任务名称。 |
—— |
|
业务日期 |
否 |
实例的业务日期,默认T-1即昨天。 |
20260907 |
|
根实例 |
重跑下游必填 |
重跑下游链路的起点实例。 |
—— |
|
下游范围 |
否 |
重跑下游链路时的范围,如所有实例或所有失败实例。 |
所有实例 |