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 లో పనిపై ఆధారపడటం, ఇది నిర్భయమైన అనువర్తనాలను నిర్మించడానికి ఈ ముఖ్యమైన ఆచరణ జ్ఞానం.