Conas a oibríonn BackgroundTasks?

Question

Accepted Answer

Tugann **`BackgroundTasks`** FastAPI deis duit obair a rith **tar éis an freagra a thabhairt ar ais** — dá bhrí sin faigheann an cliant freagra tapa agus bíonn obair dhíobhála éadrom (ríomhphost a sheoladh, login, glanadh) ag rith sa chúlra. Tá sé ionsruthaithe agus simplí, do thascanna éadroma.

## Úsáid 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
```

Insteall paraiméadar `BackgroundTasks` agus glaoch ar `add_task(func, *args)`. Cuireann FastAPI an freagra ar aghaidh ar dtús, agus ansin rithíonn sé an tasc(anna) i bhfiúntais — níl an t-úsáideoir ag feitheamh don ríomhphost.

## Tascanna iolracha agus úsáid le dépendences

```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"}
```

## An srianta ríthábhachtach: níl sé le haghaidh oibre throm/chriticiúil

```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)
```

## Cathain a úsáid cén ceann

```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)
```

## Cén fáth a bhfuil sé tábhachtach

`BackgroundTasks` is uirlis chúistí ionsruthaithe don riachtanas coitianta oibre dhíobhála a dhéanamh gan an cliant a choinneáil — ríomhphost fáiltithe a sheoladh, log a scríobh, glanadh éadrom — ag feabhasú am freagartha don úsáideoir.

Bíonn sé úsáideach an tuiscint ar a raibh sé seo a bheith agat do na cásanna éadroma gach lá seo ó nach dteastaíonn aon bhonneagar breise.

Ach an **pointe is tábhachtaí** ná a bheith ar an eolas ar a **théarmainn**: toisc go bhfeidhmíonn sé sa phróiseas céanna agus an freastalaí gréine, ní thugann sé aon bharr-bhuan (cailltear tascanna ar thuairt/athsheoladh), aon athdhíorthaí, aon sceidealú, agus níl sé oiriúnach do obair throm nó chriticiúil.

Aithint ar an teorainn seo — `BackgroundTasks` a úsáid do thascanna tapa, neamhchriticiúil, fé dhéin-éalú, agus fíor scuaireadóir tascanna ar nós **Celery/ARQ** do dhúradh, athdhíorthaí, sceidealta, nó tascanna bhreacadóireachta trom — an fhicseans ríthábhachtach a íoslaghdaíonn an mearachán coitianta a bheith ag brath ar BackgroundTasks do obair nach féidir a chailliúint, agus dá bhrí sin eolas práinneach tábhachtach do thógáil iarratas iomlán inmhianaithe.