如何在Alembic迁移中对SQLite数据库执行VACUUM操作？

SQLite 原生要求VACUUM命令必须在事务外执行，而 Alembic 默认会为每个迁移任务的upgrade()逻辑自动包裹一层事务，因此直接在迁移函数内调用op.execute("VACUUM")会触发cannot VACUUM from within a transaction错误。
该方案不需要修改env.py中的全局事务配置，仅针对需要执行VACUUM的单条迁移做特殊处理，其余迁移仍会保持默认的事务运行特性。

在需要执行VACUUM的迁移文件中，先完成冗余数据删除操作，再主动提交当前Alembic开启的事务，退出事务上下文后执行VACUUM即可，参考代码如下：

def upgrade():
    # 原有删除冗余记录的逻辑，保持不变
    # op.execute("DELETE FROM 你的表名 WHERE 冗余条件")
    # ... 其他删除逻辑

    # 获取底层数据库连接
    bind = op.get_bind()
    # 仅针对SQLite做特殊处理
    if bind.dialect.name == "sqlite":
        # 直接通过连接提交当前事务，退出事务上下文
        bind.exec_driver_sql("COMMIT")
        # 事务已关闭，可正常执行VACUUM
        bind.exec_driver_sql("VACUUM")

• 不要使用op.execute("COMMIT")提交事务：Alembic的op执行层会将语句纳入当前事务上下文，无法真正提交事务、退出事务块，必须通过绑定的底层连接对象执行提交命令才生效。
• VACUUM执行期间会独占锁整个SQLite数据库文件，执行前要确保没有其他活跃业务连接访问数据库，大库场景建议选业务低峰期运行迁移，避免阻塞正常业务。
• VACUUM执行完成后，Alembic会在后续操作（当前迁移剩余步骤、后续其他迁移任务）中自动开启新事务，不需要手动做额外的状态恢复，不会影响其他迁移的默认事务逻辑。

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