როგორ მუშაობს 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
```

Inject `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-ზე დამოკიდებულების საერთო ხარვეზს მუშაობაში, რომელიც აკრძალული უნდა იყოს დაკარგული, რაც ამ მნიშვნელოვან პრაქტიკულ ცოდნას აკეთებს საიმედო აპლიკაციების აგებისთვის.