一、集思广益
FastAPI操作数据库的文章,网上有很多。
FastAPI因其原生支持异步,且支持Pydantic标准格式校验,广泛受到开发者的青睐。
那么如何支持异步数据库?并继续支持Pydantic呢?
那么FastAPI能不能像Django那样支持 admin 后台呢?可以快捷的对数据库表进行CRUD呢?
二、SQLModel
在此,我们使用了 SQLModel
SQLModel 是一个库,用于通过 Python 代码和 Python 对象与SQL 数据库进行交互。它被设计为直观、易于使用、高度兼容和强大。
SQLModel基于 Python 类型注释,由Pydantic和SQLAlchemy提供支持。
主要特点是:
- 编写直观:强大的编辑器支持。处处圆满。更少的调试时间。旨在易于使用和学习。阅读文档的时间更少。
- 易于使用:它具有合理的默认值,并在底层做了很多工作以简化您编写的代码。
- 兼容:它旨在与FastAPI、Pydantic 和 SQLAlchemy 兼容。
- 可扩展:您拥有 SQLAlchemy 和 Pydantic 的所有功能。
- 简短:最小化代码重复。单个类型注解可以完成很多工作。无需在 SQLAlchemy 和 Pydantic 中复制模型。
配置示例代码:db_config.py
from sqlalchemy.orm import declarative_base
from sqlmodel import create_engine
sqlite_file_name = "alert.db"
sqlite_url = f"sqlite:///{sqlite_file_name}"
# mysql or sqlite all is ok
mysql_url = 'mysql+mysqlconnector://root:mysql@127.0.0.1:3306/alert_test_db'
engine = create_engine(mysql_url, echo=True)
Base = declarative_base()
模型示例代码:db_models.py
from typing import List, Optional
from sqlmodel import Field, Relationship, Session, SQLModel, create_engine
class HeroTeamLink(SQLModel, table=True):
team_id: Optional[int] = Field(
default=None, foreign_key="team.id", primary_key=True
)
hero_id: Optional[int] = Field(
default=None, foreign_key="hero.id", primary_key=True
)
class Team(SQLModel, table=True):
id: Optional[int] = Field(default=None, primary_key=True)
name: str = Field(index=True)
headquarters: str
heroes: List["Hero"] = Relationship(back_populates="teams", link_model=HeroTeamLink)
class Hero(SQLModel, table=True):
id: Optional[int] = Field(default=None, primary_key=True)
name: str = Field(index=True)
secret_name: str
age: Optional[int] = Field(default=None, index=True)
teams: List[Team] = Relationship(back_populates="heroes", link_model=HeroTeamLink)
sqlite_file_name = "database.db"
sqlite_url = f"sqlite:///{sqlite_file_name}"
engine = create_engine(sqlite_url, echo=True)
def create_db_and_tables():
SQLModel.metadata.create_all(engine)
def create_heroes():
with Session(engine) as session:
team_preventers = Team(name="Preventers", headquarters="Sharp Tower")
team_z_force = Team(name="Z-Force", headquarters="Sister Margaret’s Bar")
hero_deadpond = Hero(
name="Deadpond",
secret_name="Dive Wilson",
teams=[team_z_force, team_preventers],
)
session.add(hero_deadpond)
session.commit()
def main():
create_db_and_tables()
create_heroes()
if __name__ == "__main__":
main()
三、fastapi-amis-admin
fastapi-amis-admin 是一个拥有高性能,高效率,易拓展的fastapi管理后台框架 启发自Django-Admin,并且拥有不逊色于Django-Admin的强大功能.
界面预览
浏览器打开:<http://127.0.0.1:8000/admin/>
amdin/doc预览
浏览器打开:http://127.0.0.1:8000/admin/docs
:
快速使用 fastapi-amis-admin
安装
pip install fastapi_amis_admin
简单示例
from fastapi import FastAPI
from fastapi_amis_admin.admin.settings import Settings
from fastapi_amis_admin.admin.site import AdminSite
# 创建FastAPI应用
app = FastAPI()
# 创建AdminSite实例
site = AdminSite(settings=Settings(database_url_async='sqlite+aiosqlite:///amisadmin.db'))
# 挂载后台管理系统 site.mount_app(app)
if __name__ == '__main__':
import uvicorn
uvicorn.run(app, debug=True)