Files
Mofox-Core/src/common/database/db_migration.py
雅诺狐 69cc8fc1ab 数据库异步支持
仅仅支持还有107处待迁移
2025-11-19 23:01:18 +08:00

88 lines
3.9 KiB
Python

# mmc/src/common/database/db_migration.py
from sqlalchemy import inspect, text
from src.common.database.sqlalchemy_models import Base, get_engine
from src.common.logger import get_logger
logger = get_logger("db_migration")
async def check_and_migrate_database():
"""
异步检查数据库结构并自动迁移(添加缺失的表和列)。
"""
logger.info("正在检查数据库结构并执行自动迁移...")
engine = await get_engine()
# 使用异步引擎获取inspector
async with engine.connect() as connection:
# 在同步上下文中运行inspector操作
inspector = await connection.run_sync(lambda sync_conn: inspect(sync_conn))
# 1. 获取数据库中所有已存在的表名
db_table_names = await connection.run_sync(lambda sync_conn: set(inspect(sync_conn).get_table_names()))
# 2. 遍历所有在代码中定义的模型
for table_name, table in Base.metadata.tables.items():
logger.debug(f"正在检查表: {table_name}")
# 3. 如果表不存在,则创建它
if table_name not in db_table_names:
logger.info(f"'{table_name}' 不存在,正在创建...")
try:
await connection.run_sync(lambda sync_conn: table.create(sync_conn))
logger.info(f"'{table_name}' 创建成功。")
except Exception as e:
logger.error(f"创建表 '{table_name}' 失败: {e}")
continue
# 4. 如果表已存在,则检查并添加缺失的列
db_columns = await connection.run_sync(
lambda sync_conn: {col["name"] for col in inspect(sync_conn).get_columns(table_name)}
)
model_columns = {col.name for col in table.c}
missing_columns = model_columns - db_columns
if not missing_columns:
logger.debug(f"'{table_name}' 结构一致,无需修改。")
continue
logger.info(f"在表 '{table_name}' 中发现缺失的列: {', '.join(missing_columns)}")
# 开始事务来添加缺失的列
async with connection.begin() as trans:
try:
for column_name in missing_columns:
column = table.c[column_name]
# 构造并执行 ALTER TABLE 语句
try:
# 在同步上下文中编译列类型
column_type = await connection.run_sync(
lambda sync_conn: column.type.compile(sync_conn.dialect)
)
sql = f"ALTER TABLE {table_name} ADD COLUMN {column_name} {column_type}"
# 添加默认值和非空约束的处理
if column.default is not None:
default_value = column.default.arg
if isinstance(default_value, str):
sql += f" DEFAULT '{default_value}'"
else:
sql += f" DEFAULT {default_value}"
if not column.nullable:
sql += " NOT NULL"
await connection.execute(text(sql))
logger.info(f"成功向表 '{table_name}' 添加列 '{column_name}'")
except Exception as e:
logger.error(f"向表 '{table_name}' 添加列 '{column_name}' 失败: {e}")
except Exception as e:
logger.error(f"在表 '{table_name}' 添加列时发生错误,事务已回滚: {e}")
await trans.rollback()
raise
logger.info("数据库结构检查与自动迁移完成。")