您可以通过自然语言指令驱动Qoder、CodeX等代码Agent,修改已存在离线计算任务的代码、调度配置、数据源与上下游依赖等信息。本文为您介绍该能力的功能、使用前提与使用示例,并在附录中提供输入信息清单供参考。
功能介绍
编辑离线计算任务能力支持您通过自然语言指令,修改开发环境中已存在离线任务的配置,常见包括调整任务代码、修改调度周期与定时表达式、切换数据源、配置全天连续间隔调度、调整节点输出名、优先级与运行参数、修改上游依赖等。编辑前,Agent通常会先按任务名定位任务并读取当前配置作为基础,再进行修改。
适用场景:
-
修改已存在离线任务的代码或调度配置。
-
切换SQL类任务的数据源、库名或Catalog。
-
将任务调度改为按分钟间隔运行,或调整定时表达式。
-
调整任务的上游依赖、节点输出名、优先级或运行参数。
能力限制:编辑操作只更新开发(DEV)环境的任务配置,任务类型不可变更(如需改类型应删除后重建);改动要真正生效到生产,通常还需再执行提交与发布。上游依赖为全量覆盖,每次编辑需带上完整依赖清单,漏传会导致依赖被清空。
使用前提
-
目标Dataphin项目已存在,且当前用户为该项目成员。
-
要编辑的离线任务已在开发环境创建,可通过任务名称定位。
-
已准备好要修改的内容,如新的代码、调度配置或依赖信息。
-
编辑数据库SQL类任务时,需准备好目标数据源信息;在开发生产(DEV_PROD)双环境项目中,通常需使用生产数据源。
使用示例
您可以直接用自然语言向Agent描述需求,以下为可直接复制的指令示例:
-
「把这个任务的代码改成select * from demo01。」
-
「帮我把这个任务的调度改成全天每5分钟跑一次。」
-
「把这个SQL任务的数据源切换到另一个PostgreSQL数据源。」
-
「给这个任务加一个上游依赖,依赖shell_a任务。」
交互步骤:
-
Agent通常会先按任务名在项目目录中定位任务,缺失信息时会向您询问。
-
Agent一般会先读取任务当前配置作为模板,再按您的需求构造修改内容。
-
编辑涉及上游依赖时,Agent会带上完整的依赖清单执行更新,避免清空原有依赖。
-
修改完成后,Agent会说明改动仅在开发环境生效,如需上线还需执行提交与发布操作。
附录:输入信息
以下为编辑离线计算任务时可能涉及的信息项,仅供参考。实际使用时,Agent会根据您的指令自动识别所需信息,缺失时再向您询问;标注为无需提供的信息项由系统自动生成,您无需准备。
|
信息项 |
是否必填 |
说明 |
示例 |
|
租户ID |
是 |
操作所属的Dataphin租户标识。 |
1234567890123456789 |
|
项目ID |
是 |
任务所属的Dataphin项目。 |
—— |
|
任务名称 |
是 |
要编辑的离线任务名称,Agent据此定位任务。 |
cli_test |
|
任务类型 |
是 |
任务的作业类型,编辑时须与原类型一致,不可变更。 |
Shell |
|
任务代码 |
否 |
修改后的任务代码内容,需改代码时提供。 |
select * from demo01 |
|
调度周期 |
条件必填 |
修改调度时必填,如每天、每小时、每分钟等。 |
每分钟 |
|
定时表达式 |
条件必填 |
修改调度时必填,表达任务的具体触发时间。 |
每天0点 |
|
数据源 |
条件必填 |
数据库SQL类任务切换数据源时提供;DEV_PROD项目通常需使用生产数据源。 |
—— |
|
上游依赖 |
否 |
任务的完整上游依赖清单,编辑时为全量覆盖。 |
shell_a |
|
优先级 |
否 |
任务的调度优先级,取值范围1-9。 |
5 |