DROP TASK

DROP TASK 用于删除通过 SUBMIT TASK 提交的异步 ETL 任务。 该功能自 StarRocks v2.5.7 版本起支持。

注意

使用 DROP TASK 删除任务会同时取消对应的 TaskRun。

语法

DROP TASK [IF EXISTS] `<task_name>` [FORCE]

参数

参数	必需	描述
IF EXISTS	否	如果指定了此参数，则在删除不存在的任务时，StarRocks 不会抛出异常。 如果未指定此参数，则在删除不存在的任务时，系统将抛出异常。
task_name	是	要删除的任务的名称。 请使用反引号 (`) 包裹任务名称，以防止任何解析失败。
FORCE	否	强制删除任务。

使用说明

您可以通过查询 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>';

您可以使用 SHOW MATERIALIZED VIEWS 语句获取物化视图刷新任务的 task_name。

SHOW MATERIALIZED VIEWS;
SHOW MATERIALIZED VIEWS WHERE name = '<mv_name>';

示例

MySQL > SUBMIT /*+set_var(insert_timeout=100000)*/ TASK `ctas` AS
    -> CREATE TABLE insert_wiki_edit_new
    -> AS SELECT * FROM source_wiki_edit;
+----------+-----------+
| TaskName | Status    |
+----------+-----------+
| ctas     | SUBMITTED |
+----------+-----------+
1 row in set (1.19 sec)

MySQL > DROP TASK `ctas`;
Query OK, 0 rows affected (0.35 sec)

删除一个不存在的任务

• 如果未指定 IF EXISTS 参数，删除一个不存在的任务 test_task 会导致错误。

MySQL > DROP TASK test_task;
Query 1 ERROR: Getting analyzing error. Detail message: Task test_task is not exist.

• 如果指定了 IF EXISTS 参数，删除一个不存在的 test_task 不会导致错误。

MySQL > DROP TASK IF EXISTS test_task;
Query OK, 0 rows affected (0.00 sec)