跳到内容
光环标志
光环基地

克朗

安排在 cron 表达式上调用 Edge 函数。每个计划的运行都会将一个作业放入与异步调用相同的队列中,由工作线程池使用 - 在失败时无需重试。

说明5分钟 读取级别 中间修改于 2026年8月15日

该页面已自动翻译。英文版具有权威性。

您的功能又多了一个触发器#

除了同步 HTTP 调用和手动排队异步作业之外,aura-functions 服务还可以按计划调用边缘函数 — 请参阅 /docs/functions。没有单独的“cron”功能:任何已部署的功能都可以作为时间表的目标。

信息

Cron 计划 Edge Functions (aura-functions),而不是数据库内 SQL 作业(pg_cron 未安装在托管 Postgres 映像中)。对于数据库维护(物化视图、定期清理),请安排一个通过 @aurabase/aurabase-js 或 DATABASE_URL连接到数据库的边缘函数。

Cron 将作业排入队列,但不运行该函数#

cron 运行不会直接启动该函数:它会在队列中创建一个 作业 (与 POST /v1/functions/:projectId/jobs相同的表和相同的工作池),并在 cron 创建时冻结有效负载。然后,该工作将像其他工作一样被工人消耗掉。

预定运行周期text
TRIGGER   ────▶  进程内调度程序在预定时间触发
ENQUEUE   ────▶  创建一个作业(function_name + cron 负载)
WORKER    ────▶  工作池消耗作业,调用函数
FAILURE     ────▶  max_attempts=1 → 立即死亡(DLQ),不重试
SUCCESS    ────▶  Last_run + next_run 在 cron 线上更新
提示

当服务重新启动时,所有配置项目的所有活动 cron 都会从数据库中重新加载并重新安排 - 任务列表不会单独保留在内存中。

调度程序提供什么#

  • 进程内调度程序。 tokio-cron-scheduler + aura-functions 中的 cron 箱:无外部服务,内存中调度在启动时重新安排。
  • 每次运行都是一个作业。 cron 本身不执行任何操作:它会将作业排入队列(如异步模式下的functions.invoke),由同一工作池使用。
  • 无需重试。 由 cron 创建的作业的 max_attempts=1:失败时会将其直接切换到 DLQ(死亡),这与经典的异步作业(默认情况下尝试 3 次)不同。
  • Last_run/next_run 跟踪。 每个触发器都会对last_run 加上时间戳,并根据存储的表达式预先计算next_run - 通过listCronJobs() 可见。

创建、列出、删除#

app/cron.tstypescript
import { createClient } from '@aurabase/aurabase-js'

const aura = createClient(url, serviceRoleKey)

// 5 字段表达式(分钟、小时、日期、月份 dsem)— 秒为
// 隐式为 0。还接受 6 字段表达式(带秒)。
await aura.functions.createCronJob(
  'rollup-15min',      // 名称,每个项目唯一
  '*/15 * * * *',      // 规划
  'rollup',             // 每次运行时调用的函数
  { payload: { minutes: 15 } },
)

const { data: crons } = await aura.functions.listCronJobs()
await aura.functions.deleteCronJob('rollup-15min')
提示

每个项目的 cron 名称都是唯一的,并用作删除的标识符 (DELETE /v1/functions/:projectId/cron/:nom) — 客户端无需记住 UUID。

cron 还没有做什么#

没有专用的 CLI 命令

与函数秘密 (aura secrets) 不同,现在没有 aura functions cron 命令:计划任务的管理通过 SDK 或 REST API,而不是通过 CLI。

没有自动重试

来自 cron 的作业在第一次尝试时直接在 dead (DLQ) 中失败 — max_attempts 值得 1,而经典异步作业的默认值是 3。因此,如果要保证底层操作,则 cron 调用的函数必须处理自己的重播,否则您必须监视 DLQ (GET /v1/functions/:projectId/jobs/dlq) 并手动重播。

为了走得更远#