BackgroundTasks कैसे काम करते हैं?

Question

Accepted Answer

FastAPI के **`BackgroundTasks`** आपको प्रतिक्रिया वापस आने के **बाद काम चलाने** देते हैं — इसलिए क्लाइंट को तेज़ उत्तर मिलता है जबकि हल्के अनुवर्ती कार्य (ईमेल भेजना, लॉगिंग, सफ़ाई) पृष्ठभूमि में चलते हैं। यह अंतर्निहित और सरल है, हल्के कार्यों के लिए।

## BackgroundTasks का उपयोग

```python
from fastapi import BackgroundTasks

def send_email(address: str, message: str):
    # slow-ish work that the client shouldn't wait for
    email_client.send(address, message)

@app.post("/signup")
def signup(user: User, background_tasks: BackgroundTasks):   # inject BackgroundTasks
    save_user(user)
    background_tasks.add_task(send_email, user.email, "Welcome!")   # queue it
    return {"message": "User created"}    # RESPONSE returns NOW; email sends AFTER
```

`BackgroundTasks` पैरामीटर को इंजेक्ट करें और `add_task(func, *args)` कॉल करें। FastAPI पहले प्रतिक्रिया भेजता है, फिर कतारबद्ध कार्य(ों) को चलाता है — इसलिए उपयोगकर्ता ईमेल के लिए प्रतीक्षा नहीं करता।

## कई कार्य और निर्भरताओं के साथ उपयोग

```python
@app.post("/order")
def create_order(order: Order, bg: BackgroundTasks):
    bg.add_task(send_confirmation, order.email)
    bg.add_task(update_analytics, order.id)     # multiple tasks run in order, after the response
    return {"status": "created"}
```

## महत्वपूर्ण सीमा: यह भारी/महत्वपूर्ण कार्य के लिए नहीं है

```text
BackgroundTasks runs IN THE SAME PROCESS as the web server:
  ✗ NO persistence — if the server crashes/restarts, queued tasks are LOST
  ✗ NO retries, scheduling, or distribution
  ✗ Heavy CPU work would still tie up the worker process
→ Good for: quick, non-critical, fire-and-forget tasks (emails, logging, light cleanup)
→ For heavy, critical, retryable, or scheduled jobs → use Celery / ARQ (a real task queue)
```

## कौन सा कब उपयोग करें

```text
BackgroundTasks → simple, lightweight, best-effort work tied to a request (no extra infra)
Celery / ARQ    → durable, retryable, scheduled, distributed jobs (needs a broker/workers)
```

## यह क्यों महत्वपूर्ण है

`BackgroundTasks` सामान्य आवश्यकता के लिए एक सुविधाजनक अंतर्निहित उपकरण है — स्वागत ईमेल भेजना, लॉग लिखना, हल्की सफ़ाई — उपयोगकर्ता के लिए प्रतिक्रिया समय में सुधार करना।

इसे समझना इन रोजमर्रा के हल्के मामलों के लिए उपयोगी है क्योंकि इसमें कोई अतिरिक्त बुनियादी ढांचे की आवश्यकता नहीं है।

लेकिन **सबसे महत्वपूर्ण बात** इसकी **सीमाओं** को जानना है: क्योंकि यह वेब सर्वर की समान प्रक्रिया में चलता है, यह कोई दृढ़ता नहीं देता (दुर्घटना/पुनः शुरू पर कार्य खो जाते हैं), कोई पुनः प्रयास नहीं, कोई शेड्यूलिंग नहीं, और भारी या महत्वपूर्ण कार्य के लिए उपयुक्त नहीं है।

इस सीमा को पहचानना — तेज़, गैर-महत्वपूर्ण, फायर-एंड-फॉर्गेट कार्यों के लिए `BackgroundTasks` का उपयोग करना, और टिकाऊ, पुन: प्रयास योग्य, शेड्यूल किए गए, या भारी पृष्ठभूमि कार्यों के लिए **Celery/ARQ** जैसी वास्तविक कार्य कतार — यह महत्वपूर्ण निर्णय है जो BackgroundTasks पर भरोसा करने की सामान्य गलती को रोकता है उन कार्यों के लिए जो खोए नहीं जा सकते, इसलिए यह विश्वसनीय एप्लिकेशन बनाने के लिए महत्वपूर्ण व्यावहारिक ज्ञान है।