大网数据广告活动
数据库部署与 SQL 参考

StarRocks 中文参考:ALTER TASK

· 52CE 我爱测

# ALTER TASK ## 功能 修改通过 SUBMIT TASK 语句提交的异步 ETL 任务。此功能从 v4.1 起支持。 您可以使用该语句执行以下操作: - 暂停正在运行的任务 - 恢复已暂停的任务 - 更新任务属性 ## 语法 ## 参数说明 | **参数** | **必须** | **说明** | |-----------|--------|-----------------------------------------

ALTER TASK

功能

修改通过 SUBMIT TASK 语句提交的异步 ETL 任务。此功能从 v4.1 起支持。

您可以使用该语句执行以下操作:

  • 暂停正在运行的任务
  • 恢复已暂停的任务
  • 更新任务属性

语法

ALTER TASK [IF EXISTS] <task_name> { RESUME | SUSPEND | SET ('key' = 'value'[, ...]) }

参数说明

参数 必须 说明
IF EXISTS 否 如果声明该参数,修改不存在的任务系统不会报错。如果不声明该参数,修改不存在的任务系统会报错。
task_name 是 待修改任务名。
RESUME 否 恢复已暂停的任务。对于周期性任务,将按照原有调度计划进行调度;对于手动任务,将可继续手动执行。
SUSPEND 否 暂停正在运行的任务。对于周期性任务,将停止任务调度器并终止正在运行的任务运行。
SET 否 更新任务的属性。属性将与现有属性合并,并应用于后续的任务执行。

使用说明

  • 您可以通过查询 Information Schema 中的元数据视图 tasks 和 task_runs 来查看异步任务的信息。

    SELECT * FROM INFORMATION_SCHEMA.tasks;
    SELECT * FROM information_schema.tasks WHERE task_name = '<task_name>';
    SELECT * FROM information_schema.task_runs;
    SELECT * FROM information_schema.task_runs WHERE task_name = '<task_name>';
    
  • SUSPEND 操作会停止周期性任务的调度器,并终止当前正在运行的任务运行。任务状态将变为 PAUSE。

  • RESUME 操作会重新启动周期性任务的调度器。任务状态将变为 ACTIVE。

  • SET 操作更新任务属性,这些属性将应用于后续的任务执行。您可以通过添加 session. 前缀的会话变量来更改任务运行时的连接上下文配置。

示例

示例一:暂停名为 etl_task 的任务:

ALTER TASK etl_task SUSPEND;

示例二:恢复名为 etl_task 的已暂停任务:

ALTER TASK etl_task RESUME;

示例三:更新名为 etl_task 的任务的查询超时时间:

ALTER TASK etl_task SET ('session.query_timeout' = '5000');

示例四:更新任务的多个属性:

ALTER TASK etl_task SET (
    'session.query_timeout' = '5000',
    'session.enable_profile' = 'true'
);

示例五:仅在任务存在时暂停任务(如果任务不存在则避免报错):

ALTER TASK IF EXISTS etl_task SUSPEND;

本文来自 StarRocks 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
StarRocks 文档贡献者
适用范围
main 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。