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 'ਤੇ ਭਰੋਸਾ ਕਰਨ ਦੀ ਆਮ ਗ਼ਲਤੀ ਨੂੰ ਤੋੜਦਾ ਹੈ ਉਹ ਕੰਮ ਲਈ ਜੋ ਗੁੰਮ ਨਹੀਂ ਹੋਣਾ ਚਾਹੀਦਾ, ਭਰੋਸੇਮੰਦ ਐਪਲੀਕੇਸਨਾਂ ਬਣਾਉਣ ਲਈ ਮਹੱਤਵਪੂਰਨ ਵਹਾਂ ਵਿਹਾਰਿਕ ਗਿਆਨ।