सामग्री पर जाएँ
ऑराबेस लोगो
aurabase

क्रॉन

क्रॉन एक्सप्रेशन पर एज फ़ंक्शन के आह्वान को शेड्यूल करें। प्रत्येक निर्धारित रन एक कार्य को एसिंक्रोनस इनवोकेशन के समान कतार में रखता है, जिसका उपभोग श्रमिकों के पूल द्वारा किया जाता है - विफलता के मामले में पुनः प्रयास किए बिना।

व्याख्या5 मि॰ पढ़ेंस्तर मध्यवर्ती15 अग॰ 2026 पर संशोधित

यह पृष्ठ स्वचालित रूप से अनुवादित किया गया था. अंग्रेजी संस्करण प्रामाणिक है.

आपके कार्यों के लिए एक और ट्रिगर#

aura-functions सेवा सिंक्रोनस HTTP इनवोकेशन और मैन्युअल रूप से कतारबद्ध एसिंक्रोनस नौकरियों के अलावा, एक शेड्यूल पर एज फ़ंक्शन को लागू कर सकती है - /docs/functions देखें। कोई अलग "क्रॉन" फ़ंक्शन नहीं है: किसी भी तैनात फ़ंक्शन को शेड्यूल द्वारा लक्षित किया जा सकता है।

जानकारी

क्रॉन शेड्यूल Edge Functions (aura-functions), इन-डेटाबेस SQL ​​जॉब नहीं (pg_cron प्रबंधित Postgres छवि में स्थापित नहीं है)। डेटाबेस रखरखाव (भौतिक दृश्य, आवधिक सफाई) के लिए, एक एज फ़ंक्शन शेड्यूल करें जो @aurabase/aurabase-js या DATABASE_URL के माध्यम से आपके डेटाबेस से जुड़ता है।

क्रॉन एक कार्य को कतारबद्ध करता है, यह फ़ंक्शन नहीं चलाता है#

क्रॉन रन सीधे फ़ंक्शन लॉन्च नहीं करता है: यह कतार में एक जॉब बनाता है (समान टेबल और POST /v1/functions/:projectId/jobs के समान वर्कर पूल), क्रॉन निर्माण के समय पेलोड जमे हुए के साथ। फिर यह काम किसी भी अन्य काम की तरह एक श्रमिक द्वारा उपभोग किया जाता है।

एक निर्धारित दौड़ का चक्रtext
TRIGGER   ────▶  इन-प्रोसेस शेड्यूलर निर्धारित समय पर ट्रिगर होता है
ENQUEUE   ────▶  एक नौकरी बनाई गई है (फ़ंक्शन_नाम + क्रॉन पेलोड)
WORKER    ────▶  वर्कर पूल कार्य का उपभोग करता है, फ़ंक्शन को आमंत्रित करता है
FAILURE     ────▶  max_attempts=1 → मृत (DLQ) तुरंत, कोई पुनः प्रयास नहीं
SUCCESS    ────▶  क्रॉन लाइन पर लास्ट_रन + नेक्स्ट_रन अपडेट किया गया
सुझाव

जब सेवा को पुनरारंभ किया जाता है, तो सभी प्रावधानित परियोजनाओं के सभी सक्रिय क्रोन को डेटाबेस से पुनः लोड किया जाता है और पुनर्निर्धारित किया जाता है - कार्य सूची केवल मेमोरी में बनी नहीं रहती है।

शेड्यूलर क्या प्रदान करता है#

  • इन-प्रोसेस शेड्यूलर। टोकियो-क्रॉन-शेड्यूलर + ऑरा-फंक्शंस में क्रॉन क्रेट: कोई बाहरी सेवा नहीं, स्टार्टअप पर इन-मेमोरी शेड्यूलिंग को पुनर्निर्धारित किया गया।
  • प्रत्येक रन एक कार्य है। क्रॉन स्वयं कुछ भी निष्पादित नहीं करता है: यह एक कार्य को कतारबद्ध करता है (जैसे एसिंक्रोनस मोड में function.invoke), श्रमिकों के एक ही पूल द्वारा उपभोग किया जाता है।
  • पुनः प्रयास किए बिना। क्रॉन द्वारा बनाई गई नौकरी में max_attempts=1 होता है: एक विफलता इसे क्लासिक एसिंक्रोनस नौकरियों (डिफ़ॉल्ट रूप से 3 प्रयास) के विपरीत, सीधे DLQ (मृत) में बदल देती है।
  • Last_run/next_run ट्रैकिंग। प्रत्येक ट्रिगर टाइमस्टैम्प Last_run पर मुहर लगाता है और संग्रहित अभिव्यक्ति से Next_run की पूर्व-गणना करता है - जो listCronJobs() के माध्यम से दिखाई देता है।

बनाएं, सूचीबद्ध करें, हटाएं#

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

const aura = createClient(url, serviceRoleKey)

// 5-फ़ील्ड अभिव्यक्ति (न्यूनतम घंटा दिन महीना डीएसईएम) - सेकंड हैं
// परोक्ष रूप से 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')
सुझाव

क्रॉन का नाम प्रति प्रोजेक्ट अद्वितीय है और हटाने के लिए पहचानकर्ता के रूप में कार्य करता है (DELETE /v1/functions/:projectId/cron/:nom) - क्लाइंट पक्ष पर याद रखने के लिए कोई यूयूआईडी नहीं है।

क्रॉन क्या नहीं करता (अभी तक)#

कोई समर्पित सीएलआई कमांड नहीं

फ़ंक्शन रहस्यों (aura secrets) के विपरीत, आज कोई aura functions cron कमांड नहीं है: निर्धारित कार्यों का प्रबंधन SDK या REST API के माध्यम से होता है, CLI के माध्यम से नहीं।

कोई स्वचालित पुनः प्रयास नहीं

क्रॉन से एक नौकरी पहले प्रयास में सीधे dead (DLQ) में विफल हो जाती है - max_attempts का मूल्य 1 है, जबकि क्लासिक एसिंक्रोनस नौकरी के लिए डिफ़ॉल्ट रूप से 3 है। यदि अंतर्निहित ऑपरेशन की गारंटी दी जानी है, तो क्रॉन-आह्वान फ़ंक्शन को अपने स्वयं के रीप्ले को संभालना होगा, या आपको डीएलक्यू (GET /v1/functions/:projectId/jobs/dlq) की निगरानी करनी होगी और मैन्युअल रूप से रीप्ले करना होगा।

आगे जाने के लिए#