Alembic删除遗留表的正确迁移操作方法

方案选择：必须新建迁移，禁止修改/删除历史迁移 #

只要你找到的那份创建customer_data表的迁移文件已经提交到共享代码仓库，且已经在开发、测试、生产等任何公共环境执行过，就绝对不能直接修改文件内容、更不能删除该迁移文件。
历史迁移文件是Alembic维护版本链的核心依据，篡改已经生效的历史迁移，会直接导致所有环境的迁移版本哈希不匹配，后续所有团队成员部署、生产环境发版跑迁移时都会直接报错，严重时会导致生产数据库结构损坏。
删表的唯一正确方案是新建独立的迁移文件，在新文件的upgrade()方法中执行删表逻辑。

downgrade方法必须编写反向建表逻辑 #

Alembic迁移的核心设计要求是操作可回滚：upgrade()是执行当前迁移要做的变更，downgrade()是撤销当前变更的反向操作。
你在upgrade()里删了customer_data表，就必须在downgrade()里把这张表按照删除前的结构原封不动建回来，包括字段类型、主键、非空约束都要和原结构完全一致，否则回滚迁移时会出现表结构缺失、字段不匹配的问题，导致回滚失效。

新建迁移的两种方式都可行，没有强制要求 #

新建迁移不需要必须用命令行自动生成，两种方式都可以：

• 推荐方式：执行命令alembic revision -m "drop legacy customer_data table"生成空白迁移骨架，Alembic会自动帮你填好版本号、关联上一个迁移版本等固定信息，你只需要往upgrade和downgrade里填对应的操作逻辑即可。注意不要依赖--autogenerate自动生成逻辑，因为这张是遗留表，大概率已经不在当前项目的SQLAlchemy模型定义里了，自动生成根本识别不到要删的表，反而容易生成错误的操作。
• 手动编写：你也可以完全手动创建符合Alembic命名规范、版本号规则的迁移文件，只要保证版本链顺序正确、文件格式符合要求即可，只是这种方式容易写错版本关联关系，日常开发不推荐。

参考迁移代码示例 #

import sqlalchemy as sa
from alembic import op
# 注意根据你实际使用的数据库导入对应UUID类型，以下以PostgreSQL为例
from sqlalchemy.dialects.postgresql import UUID


# 以下版本相关字段如果用命令生成会自动填充，手动写需要自行保证正确
revision = 'a1b2c3d4e5f6'
down_revision = 'f6e5d4c3b2a1'
branch_labels = None
depends_on = None


def upgrade():
    op.drop_table('customer_data')


def downgrade():
    op.create_table(
        'customer_data',
        sa.Column('customer_id', UUID(as_uuid=True), nullable=False, primary_key=True),
        sa.Column('name', sa.String(), nullable=False),
   )

注意：正式执行删表操作前，一定要先在测试环境验证，确认该表已经没有任何业务服务读写、没有被其他表外键依赖，避免删表导致业务故障。

内容的提问来源于stack exchange，提问作者RubyLearning