クロン
cron 式での Edge 関数の呼び出しをスケジュールします。スケジュールされた実行ごとに、ジョブが非同期呼び出しと同じキューに入れられ、失敗した場合に再試行されることなく、ワーカーのプールによって消費されます。
関数のトリガーが 1 つ増えました#
aura-functions サービスは、同期 HTTP 呼び出しや手動でキューに入れられた非同期ジョブに加えて、スケジュールに従ってエッジ関数を呼び出すことができます ( /docs/functionsを参照)。個別の「cron」機能はありません。デプロイされた機能はどれもスケジュールの対象にすることができます。
Cron は、データベース内 SQL ジョブではなく、Edge Functions (aura-functions) をスケジュールします (pg_cron はマネージド Postgres イメージにインストールされません)。データベースのメンテナンス (マテリアライズド ビュー、定期的なクリーンアップ) の場合は、 @aurabase/aurabase-js または DATABASE_URLを介してデータベースに接続する Edge Function をスケジュールします。
Cron はジョブをキューに入れますが、関数は実行しません#
cron の実行では関数が直接起動されません。cron の作成時にペイロードが凍結された状態で、キュー ( POST /v1/functions/:projectId/jobsと同じテーブルおよび同じワーカー プール) に ジョブ が作成されます。その後、ジョブは他のジョブと同様にワーカーによって消費されます。
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 自体は何も実行しません。同じワーカーのプールによって消費されるジョブ (非同期モードの function.invoke など) をキューに入れます。
- 再試行なし。 cron によって作成されたジョブの max_attempts=1 は、従来の非同期ジョブ (デフォルトで 3 回の試行) とは異なり、失敗すると直接 DLQ (デッド) に切り替わります。
- Last_run/next_run の追跡。 各トリガーは、last_run のタイムスタンプを付け、保存された式から next_run を事前計算します (listCronJobs() を介して表示されます)。
作成、一覧表示、削除#
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 が(まだ)できないこと#
関数シークレット (aura secrets) とは異なり、現在 aura functions cron コマンドはありません。スケジュールされたタスクの管理は、CLI ではなく SDK または REST API を介して行われます。
cron からのジョブは最初の試行で dead (DLQ) で直接失敗します。古典的な非同期ジョブのデフォルトの 3 と比較して、 max_attempts は 1の価値があります。したがって、基礎となる操作を保証する必要がある場合、 cron によって呼び出される関数は独自のリプレイを処理する必要があります。そうでない場合は、DLQ (GET /v1/functions/:projectId/jobs/dlq) を監視して手動でリプレイする必要があります。