DBOS حالا میتونه workflowهای منتظر رو معلق کنه
خلاصهٔ کاملتر
تیم DBOS تو این پست قابلیت تازهای به اسم workflow suspension رو معرفی کرده. خیلی از durable workflowها (یعنی workflowهایی که وضعیتشون تو دیتابیس ذخیره میشه و بعد از crash ادامه پیدا میکنن) باید منتظر یه اتفاق تو دنیای واقعی بمونن، مثلاً تأیید یه reviewer یا پر شدن یه فرم. این انتظار ممکنه روزها یا حتی ماهها طول بکشه و یه اپ بزرگ راحت میلیونها workflow منتظر داشته باشه.
استفادهش سادهست: کافیه به DBOS.recv (که با timeout منتظر یه پیام میمونه) یا DBOS.sleep پارامتر suspend=True رو بدی. مثلاً برای انتظار تا یه هفته روی topic تأیید، DBOS.recv رو با timeout یه هفتهای و suspend=True صدا میزنی.
پشت صحنه، workflow اول رکورد خودش تو دیتابیس رو آپدیت میکنه: وضعیتش میشه SUSPENDED، یه «delay deadline» برابر زمان بیدار شدنش ثبت میشه و یه «suspend key» برابر topicی که منتظرشه. بعد با پرتاب یه exception مخصوص از اجرا خارج میشه. از اینجا به بعد فقط چند ردیف تو دیتابیسه و نه threadی میگیره نه حافظهای.
به گفتهی نویسنده، سختترین بخش اینه که بفهمی کِی باید workflowها رو بیدار کنی، چون نمیشه میلیونها رکورد رو مدام poll کرد. برای timeoutها یه index روی ستون delay deadline ساختن که workflowها رو از زودترین تا دیرترین زمان بیدار شدن مرتب میکنه. یه thread پسزمینه این index رو poll میکنه و بعد از بیدار کردن هر workflow، deadlineش رو پاک میکنه تا index کوچیک و کوئریها سریع بمونن.
برای پیامها، منطق خاصی تو DBOS.send گذاشتن: موقع فرستادن پیام چک میکنه که آیا suspend_key اون workflow با topic پیام یکیه یا نه. اگه آره، deadlineش رو صفر میکنه تا همون thread پسزمینه فوراً بیدارش کنه. برای جلوگیری از race condition هم workflowها قبل از معلق شدن، داخل یه transaction چک میکنن که پیام از قبل نرسیده باشه.
موقع بیدار شدن، وضعیت از SUSPENDED به ENQUEUED تغییر میکنه و workflow دوباره وارد صف میشه. بعد از روی checkpointها بازیابی میشه و دقیقاً از همون جایی که معلق شده بود ادامه میده، درست مثل بازیابی بعد از crash. نویسنده میگه قدرت durable execution همینه که کل وضعیت workflow تو دیتابیس هست.
نکات کلیدی:
- با پارامتر suspend=True روی DBOS.recv یا DBOS.sleep فعال میشه
- workflow معلق فقط چند ردیف دیتابیسه و thread، حافظه یا جای صف نمیگیره
- بیدار شدن بعد از timeout با یه index روی ستون delay deadline و یه thread پسزمینه انجام میشه
- DBOS.send با صفر کردن deadline، workflow منتظر پیام رو فوراً بیدار میکنه
- ادامهی اجرا با همون مکانیزم بازیابی از checkpoint بعد از crash انجام میشه




