SQLModel (cùng tác giả FastAPI) kết hợp Pydantic và SQLAlchemy: một lớp vừa là bảng CSDL vừa là model kiểm tra dữ liệu. Bài này kết nối SQLite rồi MySQL.

55 phútTrung cấp
Bạn sẽ học được
  • Khai báo bảng với SQLModel
  • Tạo engine, phiên làm việc
  • Kết nối SQLite và MySQL
  • Phụ thuộc phiên CSDL

Cơ sở lý thuyết

SQLAlchemy là bộ công cụ CSDL phổ biến nhất của Python, gồm Core (sinh SQL) và ORM theo mẫu Data Mapper: đối tượng không tự lưu mình, mà Session theo dõi thay đổi và ghi xuống CSDL. SQLModel kết hợp SQLAlchemy và Pydantic: một lớp vừa là bảng vừa là model kiểm tra dữ liệu.

  • Engine quản lý pool kết nối: tái sử dụng kết nối thay vì mở mới mỗi yêu cầu (mở kết nối CSDL tốn nhiều thời gian).
  • Session cài đặt mẫu Unit of Work: gom các thay đổi, commit một lần trong một giao dịch; lỗi thì rollback.
  • Chuỗi kết nối (URL) cho biết loại CSDL, driver, máy chủ: sqlite:///tep.db, mysql+pymysql://user:pass@host/db, postgresql+psycopg://...
  • Alembic quản lý migration cho SQLAlchemy, sinh tự động từ thay đổi model.

Model và kết nối

pip install sqlmodel pymysql

from sqlmodel import SQLModel, Field, Session, create_engine, select

class SinhVien(SQLModel, table=True):
    id: int | None = Field(default=None, primary_key=True)
    ma: str = Field(index=True, unique=True)
    ten: str
    diem: float = 0

engine = create_engine("sqlite:///qlsv.db")
# MySQL: create_engine("mysql+pymysql://root:@localhost/qlsv")

def lay_phien():
    with Session(engine) as phien:
        yield phien
PhienDB = Annotated[Session, Depends(lay_phien)]

@app.on_event("startup")
def khoi_tao():
    SQLModel.metadata.create_all(engine)

Với dự án lớn, dùng Alembic để quản lý thay đổi cấu trúc CSDL (giống migration của Laravel, Django).

Ứng dụng thực tế

Bài toán: mô hình hóa quan hệ một – nhiều giữa Khoa và Giảng viên, truy vấn số giảng viên mỗi khoa bằng SQL tổng hợp:

from sqlmodel import SQLModel, Field, Relationship, select, func

class Khoa(SQLModel, table=True):
    id: int | None = Field(default=None, primary_key=True)
    ten: str
    giang_viens: list["GiangVien"] = Relationship(back_populates="khoa")

class GiangVien(SQLModel, table=True):
    id: int | None = Field(default=None, primary_key=True)
    ten: str
    khoa_id: int = Field(foreign_key="khoa.id")
    khoa: Khoa = Relationship(back_populates="giang_viens")

@app.get("/thong-ke/giang-vien")
def thong_ke(db: PhienDB):
    cau = select(Khoa.ten, func.count(GiangVien.id)).join(GiangVien, isouter=True).group_by(Khoa.id)
    return [{"khoa": ten, "so_gv": so} for ten, so in db.exec(cau).all()]
Thực hành
  1. Tạo bảng sinh viên trong SQLite.
  2. Chuyển sang MySQL CSDL qlsv.
  3. Thêm bảng lớp có khóa ngoại.
Tóm tắt bài học
  • SQLModel = Pydantic + SQLAlchemy.
  • engine kết nối, Session làm việc.
  • Phiên CSDL cấp qua Depends.