SQL Task 与内核 TaskService

本文针对 v4.2.5(源码 tag v4.2.5,commit 1a44f3db3056e32975fde86ca0ab69a094996a3f)。用户 SQL Task 是 TaskService 承载的一种作业,不应把内核异步任务、daemon task、CDC 等背景工作全部当作 CREATE TASK 对象。

定义、调度与执行路径

  1. Frontend 解析 CREATE/ALTER/DROP TASK 并通过 TaskStorage 写入定义;创建时保留 account、默认库和创建者标识。SHOW TASKS、SHOW TASK RUNS 从任务存储读取定义与历史。

  2. SQL cron 服务周期性读取启用的定时任务,按六字段 cron 和时区构建定时器。命中后再次检查定义、更新时间和触发计数,将上下文转成异步任务。

  3. Task runner 调用 SQLTaskExecutor。执行器为每次 attempt 获取运行记录和并发保护,求值 WHEN,顺序运行 SQL 体,再写入成功、失败、跳过或超时记录。

  4. 手动 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 崩溃恢复和恰好一次执行,不应作此承诺。