原生 SQL Task:手动运行、门限、重试与定时调度¶
完成单机部署,使用可创建数据库和 Task 的测试账号。在独立实例或测试 account 中执行;Task 名在 account 内唯一,本页使用 mo_docs_task_*,运行前确认没有同名任务。删除 Task 后再删除它使用的数据库。
原生 SQL Task 已存在于 v4.2.5;它与 MySQL EVENT、外部 DolphinScheduler 和内核 TaskService 的其他任务不同。完整语法见SQL Task 参考。
提交完整任务体¶
驱动必须把完整 CREATE TASK ... AS BEGIN ... END 作为一个请求提交,不能按内部 ; 切开。MySQL 命令行可先执行 DELIMITER $$,用 END$$ 结束整个创建请求,再恢复 DELIMITER ;;DELIMITER 仅是客户端命令,不发送给数据库。以下 SQL 块适用于能提交完整语句的驱动或编辑器。
手动执行、门限与幂等写入¶
CREATE DATABASE mo_task_lab;
USE mo_task_lab;
CREATE TABLE task_sink(id INT PRIMARY KEY);
CREATE TABLE task_gate(id INT PRIMARY KEY);
CREATE TASK mo_docs_task_gate
WHEN (EXISTS(SELECT 1 FROM task_gate WHERE id=1))
RETRY 1 TIMEOUT '30s'
AS BEGIN
INSERT INTO task_sink
SELECT 1 WHERE NOT EXISTS(SELECT 1 FROM task_sink WHERE id=1);
END;
EXECUTE TASK mo_docs_task_gate;
-- Expected-Value: 0
SELECT COUNT(*) FROM task_sink;
SHOW TASK RUNS FOR mo_docs_task_gate LIMIT 1;
INSERT INTO task_gate VALUES(1);
EXECUTE TASK mo_docs_task_gate;
EXECUTE TASK mo_docs_task_gate;
-- Expected-Value: 1
SELECT COUNT(*) FROM task_sink;
ALTER TASK mo_docs_task_gate SUSPEND;
EXECUTE TASK mo_docs_task_gate;
-- Expected-Value: 1
SELECT COUNT(*) FROM task_sink;
SHOW TASK RUNS FOR mo_docs_task_gate LIMIT 5;
DROP TASK mo_docs_task_gate;
SHOW TASK RUNS FOR mo_docs_task_gate LIMIT 5;
DROP DATABASE mo_task_lab;
门限为空时首次执行返回成功但不写入,运行历史状态为 SKIPPED,且不做重试。插入门限行后状态为 SUCCESS。重复执行仍只有一行,这是 SQL 中主键和去重条件的效果。SUSPEND 关闭定时触发,手动 EXECUTE TASK 仍然执行;删除定义后历史仍可查询。
重试不等于整体回滚¶
下面第二条 SQL 故意失败,RETRY 1 意味着最多两次尝试。运行前确保缺失表未创建;EXECUTE TASK 预期报错,随后继续查询数据和历史。
CREATE DATABASE mo_task_retry_lab;
USE mo_task_retry_lab;
CREATE TABLE task_effects(id INT);
CREATE TASK mo_docs_task_retry RETRY 1
AS BEGIN
INSERT INTO task_effects VALUES(1);
INSERT INTO missing_task_lab_table VALUES(1);
END;
-- Expected-Success: false
EXECUTE TASK mo_docs_task_retry;
-- Expected-Value: 2
SELECT COUNT(*) FROM task_effects;
SHOW TASK RUNS FOR mo_docs_task_retry LIMIT 2;
DROP TASK mo_docs_task_retry;
DROP DATABASE mo_task_retry_lab;
v4.2.5 实测留下 2 行,历史有 FAILED 的 attempt 1、2。Task 逐条执行 SQL,前一条成功写入会保留;重试从任务体开头开始。BEGIN ... END 是任务体包装,不提供整段事务原子性。使用幂等写入、防重复业务键和水位检查;不要把重试视为 exactly-once。
Task 调用一个 SQL 过程¶
若目标写入和水位更新必须一起失败,可先把 DML 放入一个 SQL 过程,再在 Task 中调用。下面验证的是该过程未处理 SQL 错误时的回滚,不能推广为所有过程或所有任务的保证。
CREATE DATABASE mo_task_call_lab;
USE mo_task_call_lab;
CREATE TABLE task_rows(id INT);
CREATE TABLE task_watermark(id INT PRIMARY KEY, pos INT);
INSERT INTO task_watermark VALUES(1,0);
CREATE PROCEDURE task_ingest_fail()
'begin INSERT INTO task_rows VALUES(1); UPDATE task_watermark SET pos=1 WHERE id=1; INSERT INTO missing_task_call_table VALUES(1); end';
CREATE TASK mo_docs_task_call AS BEGIN CALL task_ingest_fail(); END;
-- Expected-Success: false
EXECUTE TASK mo_docs_task_call;
-- Expected-Value: 0
SELECT COUNT(*) FROM task_rows;
-- Expected-Value: 0
SELECT pos FROM task_watermark WHERE id=1;
DROP TASK mo_docs_task_call;
DROP PROCEDURE task_ingest_fail;
DROP DATABASE mo_task_call_lab;
预期目标行数和水位均为 0。过程体使用字符串,与 Task 的直接 AS BEGIN ... END 语法不同。
定时执行实验¶
这个实验依赖后台调度和等待,下面保留语法验证,执行过程需手动分阶段完成。创建后,先等待并重复查询历史,直到出现 trigger_type=SCHEDULED 且 status=SUCCESS,再执行挂起、恢复和清理。不保证创建后马上出现运行记录;秒级 cron 表达式不是调度延迟承诺。
CREATE DATABASE mo_task_cron_lab;
USE mo_task_cron_lab;
CREATE TABLE cron_sink(marker VARCHAR(20));
CREATE TASK mo_docs_task_cron
SCHEDULE '*/5 * * * * *' TIMEZONE 'UTC'
TIMEOUT '30s'
AS BEGIN
INSERT INTO cron_sink VALUES('scheduled');
END;
SHOW TASKS;
SHOW TASK RUNS FOR mo_docs_task_cron LIMIT 5;
ALTER TASK mo_docs_task_cron SUSPEND;
ALTER TASK mo_docs_task_cron RESUME;
ALTER TASK mo_docs_task_cron SUSPEND;
DROP TASK mo_docs_task_cron;
DROP DATABASE mo_task_cron_lab;
SCHEDULE 使用含秒的六字段形式;省略 TIMEZONE 为 UTC。SUSPEND 后已开始的运行可能仍完成;检查历史区分正在执行与新触发。恢复后再次等到新的成功记录。SHOW TASKS 查看定义与最后状态;SHOW TASK RUNS 查看触发方式、attempt、耗时和错误。
超时与故障排查¶
v4.2.5 将超时存为整数秒,
500ms会截为 0(无任务体超时),1500ms会截为 1 秒。使用明确的正整数秒;TIMEOUT '1s'执行SLEEP(2)的任务实测约 1 秒失败并记录TIMEOUT。task service not ready yet:等待 TaskService 就绪后重试;不要在应用启动阶段假定服务立即可用。sql task is already running:同名任务已有活动运行;第二次手动触发实测会拒绝。检查历史,避免多个调度入口同时启动同一任务。FAILED后先检查已提交数据再重试;rows_affected不表示整段 SQL 已回滚。原生 Task 适合数据库内 SQL 作业;跨系统依赖、复杂 DAG 和外部程序编排可使用 DolphinScheduler。
手动、门限、重试、超时、并发拒绝、定时触发和删除后历史保留于 2026-10-14 在单 CN v4.2.5 实测;不构成多 CN 故障接管、权限隔离或生产调度容量认证。