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

StarRocks 中文参考:SUBMIT TASK

· 52CE 我爱测

您可以通过查询 查看任务列表,或通过查询 查看任务的执行历史。有关更多信息,请参阅使用说明。

SUBMIT TASK

功能

为 ETL 语句创建异步任务。

您可将该语句用于以下场景:

  • 创建长时间运行的后台任务(从 v2.5 开始支持)
  • 创建定期执行的任务(从 v3.3 开始支持)

支持的语句包括:

您可以通过查询 INFORMATION_SCHEMA.tasks 查看任务列表,或通过查询 INFORMATION_SCHEMA.task_runs 查看任务的执行历史。有关更多信息,请参阅使用说明。

您可以使用 ALTER TASK 修改异步任务,或使用 DROP TASK 删除异步任务。

语法

SUBMIT TASK <task_name> 
[SCHEDULE [START(<schedule_start>)] EVERY(INTERVAL <schedule_interval>) ]
[PROPERTIES(<"key" = "value"[, ...]>)]
AS <etl_statement>

PROPERTIES

您可以通过添加 session. 前缀的会话变量来更改任务运行时的连接上下文配置。

属性 类型 说明
session.query_timeout Integer 查询超时时间。单位:秒。取值范围:1 到 259200。默认值:300。自 v3.4.0 起,该变量不适用于 INSERT 操作。
session.insert_timeout Integer INSERT 操作的超时时间。单位:秒。默认值:14400。自 v3.4.0 起支持。
session.enable_profile Boolean 是否为任务开启查询 Profile。默认值:false。
session.new_planner_optimize_timeout Integer 查询优化器的超时时间。单位:毫秒。默认值:3000。

例如,以下语句提交了一个名为 test_task 的任务,并启用了查询分析和增加了查询超时时间:

SUBMIT TASK test_task
PROPERTIES (
    "session.enable_profile" = "true",
    "session.insert_timeout" = "10000"
)
AS insert into t2 select * from t1;

参数说明

参数 是否必须 描述
task_name 是 任务名称。
schedule_start 否 定时任务的开始时间。
schedule_interval 否 定时任务的执行间隔,最小间隔为 10 秒。
etl_statement 是 需要创建异步任务的 ETL 语句。StarRocks 当前支持为 CREATE TABLE AS SELECT 和 INSERT

返回值

  • TaskName:任务的名称。
  • Status:任务的状态。有效值:
    • SUBMITTED:任务已提交。
    • REJECTED:任务已被拒绝。
    • FAILED:任务已失败。

使用说明

该语句会创建一个 Task,表示一个 ETL 语句执行任务的存储模板。您可以通过查询 Information Schema 中的元数据视图 tasks 来查看 Task 信息:

SELECT * FROM INFORMATION_SCHEMA.tasks;
SELECT * FROM information_schema.tasks WHERE task_name = '<task_name>';

执行 Task 后会对应生成一个 TaskRun,表示一个 ETL 语句执行任务。TaskRun 有以下状态:

  • PENDING:任务等待执行。
  • RUNNING:任务正在执行。
  • FAILED:任务执行失败。
  • SUCCESS:任务执行成功。

您可以通过查询 Information Schema 中的元数据视图 task_runs 来查看 TaskRun 状态:

SELECT * FROM INFORMATION_SCHEMA.task_runs;
SELECT * FROM information_schema.task_runs WHERE task_name = '<task_name>';

相关 FE 参数

您可以通过调整如下 FE 参数配置异步 ETL 任务:

参数 默认值 说明
task_ttl_second 86400 Task 的有效期,单位秒。超过有效期的 Task 会被自动删除。Task 是指只执行一次的非周期性任务。
task_check_interval_second 3600 删除过期 Task 的间隔时间,单位秒。
task_runs_ttl_second 86400 TaskRun 的有效期,单位秒。超过有效期的 TaskRun 会被自动删除。此外,成功和失败状态的 TaskRun 也会被自动删除。对于周期任务,其每次周期执行称为 TaskRun。
task_runs_concurrency 4 最多可同时运行的 TaskRun 的数量。
task_runs_dispatch_interval_ms 1000 Leader FE 检查 running TaskRun 并调度 pending TaskRun 的间隔,单位毫秒。可在线修改,无需重启 FE。新间隔在当前调度周期结束后生效。
task_runs_queue_length 500 最多可同时等待运行的 TaskRun 的数量。如同时等待运行的 TaskRun 的数量超过该参数的默认值,您将无法继续执行 Task。
task_runs_max_history_number 10000 保留的最多历史 TaskRun 任务数量。
task_min_schedule_interval_s 10 Task 最小执行间隔。单位:秒。

示例

示例一:为 CREATE TABLE tbl1 AS SELECT * FROM src_tbl 创建异步任务,并命名为 etl0:

SUBMIT TASK etl0 AS CREATE TABLE tbl1 AS SELECT * FROM src_tbl;

示例二:为 INSERT INTO tbl2 SELECT * FROM src_tbl 创建异步任务,并命名为 etl1:

SUBMIT TASK etl1 AS INSERT INTO tbl2 SELECT * FROM src_tbl;

示例三:为 INSERT OVERWRITE tbl3 SELECT * FROM src_tbl 创建异步任务:

SUBMIT TASK AS INSERT OVERWRITE tbl3 SELECT * FROM src_tbl;

示例四:为 INSERT OVERWRITE insert_wiki_edit SELECT * FROM source_wiki_edit 创建异步任务,并通过 Hint 将 Query Timeout 设置为 100000 秒:

SUBMIT /*+set_var(insert_timeout=100000)*/ TASK AS
INSERT OVERWRITE insert_wiki_edit
SELECT * FROM source_wiki_edit;

示例五:为 INSERT OVERWRITE 语句创建异步任务。任务将以一分钟为间隔定期执行。

SUBMIT TASK
SCHEDULE EVERY(INTERVAL 1 MINUTE)
AS
INSERT OVERWRITE insert_wiki_edit
    SELECT dt, user_id, count(*) 
    FROM source_wiki_edit 
    GROUP BY dt, user_id;

示例六:创建具有自定义会话属性的任务:

SUBMIT TASK test_task
PROPERTIES (
    "session.enable_profile" = "true",
    "session.insert_timeout" = "10000"
)
AS insert into t2 select * from t1;

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

资料来源与适用范围

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

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

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