SQL Task 与内核 TaskService¶
本文针对 v4.2.5(源码 tag v4.2.5,commit 1a44f3db3056e32975fde86ca0ab69a094996a3f)。用户 SQL Task 是 TaskService 承载的一种作业,不应把内核异步任务、daemon task、CDC 等背景工作全部当作 CREATE TASK 对象。
定义、调度与执行路径¶
Frontend 解析
CREATE/ALTER/DROP TASK并通过 TaskStorage 写入定义;创建时保留 account、默认库和创建者标识。SHOW TASKS、SHOW TASK RUNS从任务存储读取定义与历史。SQL cron 服务周期性读取启用的定时任务,按六字段 cron 和时区构建定时器。命中后再次检查定义、更新时间和触发计数,将上下文转成异步任务。
Task runner 调用 SQLTaskExecutor。执行器为每次 attempt 获取运行记录和并发保护,求值
WHEN,顺序运行 SQL 体,再写入成功、失败、跳过或超时记录。手动
EXECUTE TASK使用同一个执行器并记录MANUAL,但不需要等待 cron 命中;SUSPEND不阻止这个入口。
需要保留的语义区别¶
Task 定义与执行历史不同。删除定义后历史保留;不能用
SHOW TASKS是否有行判断过去是否运行。调度命中与运行成功不同。历史的
SCHEDULED标识触发方式,SUCCESS才表示这次执行完成;cron 含秒不保证端到端秒级延迟。执行器为每条 SQL 调用 InternalExecutor,Task 体不构成一个整体事务。重试重复从头执行,应由业务设计处理重复写入。
超时保存为整数秒,小于一秒截为零;门限求值有自己的内部超时。任务体
TIMEOUT不能当作整个调度链路的截止时间。创建者上下文被传入内部执行,不等于跨租户权限授权。隔离、故障恢复和多 CN 接管需要单独的拓扑与权限实验。
源码与验证入口¶
以下链接固定到 v4.2.5,便于区分后续版本修改:
2026-10-14 的单 CN 实测覆盖手动、cron、门限、重试、超时、并发拒绝和历史保留;没有验证跨 CN 崩溃恢复和恰好一次执行,不应作此承诺。