Files
student_management_system/database.py
T
2026-09-21 17:30:02 +08:00

50 lines
1.8 KiB
Python

# database.py
# 本文件负责配置数据库连接、创建引擎、会话工厂,并提供依赖注入函数
import os
from sqlalchemy import create_engine
from sqlalchemy.engine import URL
from sqlalchemy.orm import sessionmaker
from sqlalchemy.orm.decl_api import declarative_base
# 1. 配置 MySQL 数据库连接 URL
# 格式:mysql+pymysql://用户名:密码@主机:端口/数据库名?编码
# 请将下面的 'root', '123456', 'localhost', '3306', 'test_db' 替换为你自己的实际信息
SQLALCHEMY_DATABASE_URL = os.getenv("DATABASE_URL") or URL.create(
"mysql+pymysql",
username=os.getenv("DB_USER", "root"),
password=os.getenv("DB_PASSWORD", "123456"),
host=os.getenv("DB_HOST", "localhost"),
port=int(os.getenv("DB_PORT", "3306")),
database=os.getenv("DB_NAME", "student_management_system"),
query={"charset": "utf8mb4"},
)
# 2. 创建数据库引擎
engine = create_engine(
SQLALCHEMY_DATABASE_URL,
pool_size=5,
pool_pre_ping=True,
)
# 3. 创建会话工厂
# autocommit=False:不自动提交,需要手动 commit
# autoflush=False:不自动 flush,在查询前会自动 flush,一般保持默认
SessionLocal = sessionmaker(autocommit=False, autoflush=False, bind=engine)
# 4. 创建声明式基类,所有模型类都继承自它
Base = declarative_base()
# 5. 依赖注入函数:用于 FastAPI 路由中获取数据库会话
def get_db():
"""
每次请求创建一个数据库会话,请求结束后关闭。
这个函数会作为 Depends 的参数注入到路由中。
"""
db = SessionLocal() # 创建一个会话实例
try:
yield db # 将会话交给路由函数使用
finally:
db.close() # 无论是否发生异常,最后都会关闭会话,释放连接