重跑任务实例SKILL

更新时间:
复制 MD 格式

您可以通过自然语言指令驱动Qoder、CodeX等代码Agent,重跑Dataphin调度任务实例,支持单实例或批量重跑,也支持以根实例为起点联动重跑整条下游链路。本文为您介绍该能力的功能、使用前提、使用示例与执行结果,并在附录中提供输入信息清单供参考。

功能介绍

重跑任务实例能力支持您通过自然语言指令,对Dataphin调度任务实例触发重新执行,常见包括按任务名与业务日期定位实例后重跑单个或批量实例,以及以某个根实例为起点联动重跑该实例及其所有下游节点(修复整条数据链路),重跑后还可查看实例最新状态与运行日志。

适用场景:

  • 周期实例失败、等待调度超时或被暂停后,需要手动触发重新执行。

  • 批量重跑某个业务日期下的多个失败实例。

  • 以根实例为起点联动重跑整条下游链路,修复链路数据。

  • 只重跑下游链路中的失败实例。

说明

能力限制:重跑不等于修复,若任务配置或源数据本身有问题,重跑仍会失败,需结合日志诊断;单实例重跑后实例状态会随之变化,而重跑下游链路不创建新实例、只在原实例下新增运行记录,两者的验证方式不同;匹配到多条实例时须确认唯一目标,不会直接全部重跑。

使用前提

  • 已知目标租户ID与项目ID。

  • 已知目标任务名称与业务日期(默认T-1,即昨天)。

  • 目标实例已存在,例如失败、超时或被暂停。

  • 重跑下游链路时,需明确根实例与下游范围。

使用示例

您可以直接用自然语言向Agent描述需求,以下为可直接复制的指令示例:

  • 重跑某个任务昨天(业务日期)失败的实例。

  • 批量重跑某个业务日期下的多个失败实例。

  • 以某个根实例为起点,联动重跑它及其所有下游节点。

  • 只重跑下游链路中的失败实例。

  • 重跑后查看实例的最新状态。

  • 重跑仍失败时拉取运行日志排查原因。

交互步骤:

  1. Agent通常会先与您确认目标项目、任务名称、业务日期(默认T-1,即昨天)与环境(开发或生产)。

  2. Agent通常会先定位目标实例,同名任务可能跨多个项目,若匹配到多条会向您展示并确认唯一目标。

  3. 执行重跑前,Agent通常会与您确认实例、任务名、项目、环境与业务日期;重跑下游链路时还会确认根实例、下游范围与是否包含根实例。

  4. 单实例重跑后,Agent通常会查询实例状态确认是否由失败转为运行中乃至成功,仍失败时拉取日志定位根因。

  5. 重跑下游链路不创建新实例,Agent通常会通过实例的运行日志确认是否新增了运行记录并成功。

执行结果

操作完成后,您可以获得以下结果:

  • 返回内容:重跑返回运维指令是否下发成功,实例状态查询返回最新状态与起止时间、耗时,日志查询返回各次运行记录与日志内容。

  • 完成状态:指令下发成功不等于实例最终成功;单实例重跑以实例状态由失败转为成功为准,重跑下游链路以各实例新增运行记录且状态成功为准。

  • 查看与验证:可通过实例状态与运行日志核对重跑结果;若仍失败,可结合日志排查数据源权限、目标表或字段不存在、资源排队等常见原因。

说明

命令行返回成功仅表示请求已受理,最终请以Dataphin界面显示的实际结果为准。

附录:输入信息

以下为重跑任务实例时可能涉及的信息项,仅供参考。实际使用时,Agent会根据您的指令自动识别所需信息,缺失时再向您询问;标注为无需提供的信息项由系统自动生成,您无需准备。

信息项

是否必填

说明

示例

租户ID

条件必填

已在凭证配置中指定时可省略。

1234567890123456789

项目ID

是

实例所属项目。

——

环境

否

开发或生产,默认生产。

生产

任务名称

是

要重跑的任务名称。

——

业务日期

否

实例的业务日期,默认T-1即昨天。

20260907

根实例

重跑下游必填

重跑下游链路的起点实例。

——

下游范围

否

重跑下游链路时的范围,如所有实例或所有失败实例。

所有实例