Πώς ενσωματώνετε μια SQL βάση δεδομένων με FastAPI;

Question

Accepted Answer

Σε αντίθεση με το Django, το FastAPI είναι **ουδέτερο** σχετικά με τις βάσεις δεδομένων — εσείς επιλέγετε τη βιβλιοθήκη. Η συνηθισμένη επιλογή είναι το **SQLAlchemy** (συχνά με **SQLModel**, του συγγραφέα του FastAPI, το οποίο συνδυάζει SQLAlchemy + Pydantic). Οι περίοδοι σύνδεσης βάσης δεδομένων παρέχονται μέσω της ένεσης εξάρτησης.

## SQLAlchemy setup

```python
from sqlalchemy import create_engine
from sqlalchemy.orm import sessionmaker, declarative_base

engine = create_engine("postgresql://user:pass@localhost/db")
SessionLocal = sessionmaker(bind=engine)
Base = declarative_base()

class User(Base):                        # an ORM model (maps to a table)
    __tablename__ = "users"
    id = Column(Integer, primary_key=True)
    name = Column(String)
    email = Column(String, unique=True)
```

## Providing the DB session via a dependency

```python
def get_db():
    db = SessionLocal()
    try:
        yield db                 # provide the session
    finally:
        db.close()               # ALWAYS close after the request (cleanup)

@app.get("/users/{id}")
def get_user(id: int, db: Session = Depends(get_db)):   # inject a session per request
    user = db.query(User).filter(User.id == id).first()
    if not user:
        raise HTTPException(404, "Not found")
    return user
```

Το pattern `yield` dependency είναι ο τυπικός τρόπος διαχείρισης περιόδων: ανοίξτε μια ανά αίτημα, ενέσετε την, και κλείστε την αμέσως αμέσως — κάθε endpoint παίρνει μια καθαρή, σωστά κλειστή περίοδο.

## SQLModel — SQLAlchemy + Pydantic in one

```python
from sqlmodel import SQLModel, Field, Session, select

class User(SQLModel, table=True):        # ONE class = ORM model AND Pydantic model
    id: int | None = Field(default=None, primary_key=True)
    name: str
    email: str

@app.get("/users")
def list_users(db: Session = Depends(get_session)):
    return db.exec(select(User)).all()    # query; results are also valid response models
```

Το SQLModel ενοποιεί το ORM model και το Pydantic model σε μία κλάση — μειώνοντας την αναπαραγωγή μεταξύ σχημάτων βάσης δεδομένων και API.

## Migrations and async options

```text
✓ Migrations: use Alembic (SQLAlchemy's migration tool) for schema changes
✓ Async: use SQLAlchemy's async engine + async session for async endpoints
  (don't use a SYNC database driver inside async def — it blocks the event loop)
```

## Γιατί έχει σημασία

Η ενσωμάτωση της βάσης δεδομένων είναι απαραίτητη για σχεδόν κάθε πραγματικό API, και επειδή το FastAPI είναι σκόπιμα **ουδέτερο** σχετικά με αυτό (σε αντίθεση με το ενσωματωμένο ORM του Django), η κατανόηση της συνηθισμένης προσέγγισης είναι σημαντική πρακτική γνώση.

Το τυπικό pattern — **SQLAlchemy** (ή **SQLModel**, το οποίο κομψά ενοποιεί το ORM και τα Pydantic models για να μειώσει τη διπλότυπη) με **dependency-injected sessions** μέσω του pattern `yield` — είναι αυτό που χρησιμοποιεί σχεδόν κάθε FastAPI εφαρμογή για να παραμείνουν τα δεδομένα.

Η περίοδος-ανά-αίτημα εξάρτηση (ανοίξτε πριν, κλείστε μετά, αυτόματα) είναι ο ιδιωματικός, σωστός τρόπος διαχείρισης συνδέσεων βάσης δεδομένων, και η ενοποίηση του SQLModel των σχημάτων βάσης δεδομένων και API είναι μια αξιοσημείωτη δυνατότητα παραγωγικότητας από τον δικό του συγγραφέα του FastAPI.

Η γνώση του τρόπου ρύθμισης της βάσης δεδομένων, παροχής περιόδων μέσω DI, εκτέλεσης ερωτημάτων και χειρισμού των migrations (Alembic) και της async προειδοποίησης (χρήση async drivers στα async endpoints, ποτέ μη-blocking sync ones) είναι απαραίτητη για τη δημιουργία δεδομένων-κεντρικών FastAPI εφαρμογών — επειδή το FastAPI σας δίνει την ελευθερία να επιλέξετε, η γνώση της συμβατικής, καλά διαδεδομένης διαδρομής είναι πολύτιμη για τη δημιουργία πραγματικών εφαρμογών σωστά.