编辑离线计算任务SKILL

更新时间:
复制 MD 格式

您可以通过自然语言指令驱动Qoder、CodeX等代码Agent,修改已存在离线计算任务的代码、调度配置、数据源与上下游依赖等信息。本文为您介绍该能力的功能、使用前提与使用示例,并在附录中提供输入信息清单供参考。

功能介绍

编辑离线计算任务能力支持您通过自然语言指令,修改开发环境中已存在离线任务的配置,常见包括调整任务代码、修改调度周期与定时表达式、切换数据源、配置全天连续间隔调度、调整节点输出名、优先级与运行参数、修改上游依赖等。编辑前,Agent通常会先按任务名定位任务并读取当前配置作为基础,再进行修改。

适用场景:

  • 修改已存在离线任务的代码或调度配置。

  • 切换SQL类任务的数据源、库名或Catalog。

  • 将任务调度改为按分钟间隔运行,或调整定时表达式。

  • 调整任务的上游依赖、节点输出名、优先级或运行参数。

说明

能力限制:编辑操作只更新开发(DEV)环境的任务配置,任务类型不可变更(如需改类型应删除后重建);改动要真正生效到生产,通常还需再执行提交与发布。上游依赖为全量覆盖,每次编辑需带上完整依赖清单,漏传会导致依赖被清空。

使用前提

  • 目标Dataphin项目已存在,且当前用户为该项目成员。

  • 要编辑的离线任务已在开发环境创建,可通过任务名称定位。

  • 已准备好要修改的内容,如新的代码、调度配置或依赖信息。

  • 编辑数据库SQL类任务时,需准备好目标数据源信息;在开发生产(DEV_PROD)双环境项目中,通常需使用生产数据源。

使用示例

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

  • 「把这个任务的代码改成select * from demo01。」

  • 「帮我把这个任务的调度改成全天每5分钟跑一次。」

  • 「把这个SQL任务的数据源切换到另一个PostgreSQL数据源。」

  • 「给这个任务加一个上游依赖,依赖shell_a任务。」

交互步骤:

  1. Agent通常会先按任务名在项目目录中定位任务,缺失信息时会向您询问。

  2. Agent一般会先读取任务当前配置作为模板,再按您的需求构造修改内容。

  3. 编辑涉及上游依赖时,Agent会带上完整的依赖清单执行更新,避免清空原有依赖。

  4. 修改完成后,Agent会说明改动仅在开发环境生效,如需上线还需执行提交与发布操作。

附录:输入信息

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

信息项

是否必填

说明

示例

租户ID

是

操作所属的Dataphin租户标识。

1234567890123456789

项目ID

是

任务所属的Dataphin项目。

——

任务名称

是

要编辑的离线任务名称,Agent据此定位任务。

cli_test

任务类型

是

任务的作业类型,编辑时须与原类型一致,不可变更。

Shell

任务代码

否

修改后的任务代码内容,需改代码时提供。

select * from demo01

调度周期

条件必填

修改调度时必填,如每天、每小时、每分钟等。

每分钟

定时表达式

条件必填

修改调度时必填,表达任务的具体触发时间。

每天0点

数据源

条件必填

数据库SQL类任务切换数据源时提供;DEV_PROD项目通常需使用生产数据源。

——

上游依赖

否

任务的完整上游依赖清单,编辑时为全量覆盖。

shell_a

优先级

否

任务的调度优先级,取值范围1-9。

5