CRUD là bộ bốn thao tác tạo – đọc – sửa – xóa mà gần như mọi API đều cần. Cách chuẩn trong FastAPI là gom logic database vào các hàm CRUD dùng SQLAlchemy 2.0 — select(), db.get(), db.add(), db.delete() — lấy session qua dependency yield tên get_db, và khai báo response_model cùng status_code rõ ràng ở từng endpoint.

Khi viết API Flask, gần như endpoint nào cũng cần lấy một bản ghi theo ID: xem chi tiết user, sửa bài viết, xóa đơn hàng. Flask-SQLAlchemy 3.x có sẵn ba hàm get_or_404(), first_or_404() và one_or_404() — lấy được thì trả object, không có thì tự abort 404, khỏi viết if ... is None: abort(404) lặp đi lặp lại. Ba hàm này dùng được ngay khi bạn đã cài Flask-SQLAlchemy 3.0 trở lên.

Sqlalchemy Json Querybuilder converts JSON specifications into SQLAlchemy ORM queries, enabling developers to build dynamic database queries programmatically without writing raw SQL. This tool simplifies query construction for Python applications by providing a structured JSON-to

Nếu bạn đang dùng Flask-SQLAlchemy 3.x mà vẫn viết Post.query.filter(...).all(), bạn đang dùng giao diện truy vấn cũ của SQLAlchemy 1.x. Cách chuẩn hiện nay là db.select() kết hợp db.session.execute(), kèm db.session.get() để lấy một bản ghi theo khóa chính. Bài này đổi một truy vấn mẫu sang kiểu mới, để code thống nhất với tài liệu SQLAlchemy 2.0 và dễ mở rộng về sau.

Connect PostgreSQL to FastAPI with SQLAlchemy 2.0 and psycopg 3: a tested step-by-step build of a books API with pooling, sessions, and real curl output.

Khi endpoint của bạn chỉ gọi hàm đồng bộ — ví dụ requests, SQLAlchemy đồng bộ hay xử lý CPU — hãy khai báo bằng def, FastAPI sẽ chạy nó trong threadpool và không chặn các request khác. Chỉ dùng async def khi bên trong có await thật sự, như gọi httpx.AsyncClient hay database bất đồng bộ. Quy tắc này áp dụng cho mọi endpoint.

Mỗi request tới API nên có một DB session riêng, và session đó phải được đóng ngay sau khi request xong — dù thành công hay thất bại. Cách chuẩn trong FastAPI là viết một dependency dùng yield: đoạn code trước yield tạo session và giao cho endpoint, đoạn code sau yield (đặt trong finally) luôn đóng session. Áp dụng mẫu này cho mọi endpoint dùng SQLAlchemy hoặc SQLModel là xong.

When Flask-SQLAlchemy hits a save error — a duplicate unique email, for example — the session does not recover on its own: every later operation in the same session throws PendingRollbackError until you call rollback. The fix is to wrap commit in try/except IntegrityError and call db.session.rollback() right inside the except block. This applies to every write path: user registration, order creation, bulk import, or a seed script.

Offset-free paging for SQLAlchemy

Prefect gave $40,000 to 12 open source maintainers, project teams, and collectives in 2026, supporting the libraries behind Prefect, Dagster, and FastMCP.

Khi Flask-SQLAlchemy gặp lỗi lưu dữ liệu, ví dụ trùng email duy nhất, session không tự hồi phục: mọi thao tác sau đó trong cùng session đều ném lỗi PendingRollbackError cho tới khi bạn gọi rollback. Giải pháp là bọc commit trong try/except IntegrityError và gọi db.session.rollback() ngay trong khối except. Cách này áp dụng cho mọi chỗ ghi dữ liệu: đăng ký tài khoản, tạo đơn hàng, import hàng loạt hay script seed.