用途:为数据库模式与数据提供跨环境的版本控制策略,覆盖随时间跟踪模式变更、协调 dev/staging/prod 变更、实现数据库审计追踪、管理存储过程与函数、对参考数据进行版本化。
主要能力: 模式版本:通过 schema_version 表记录版本号、描述、应用时间、执行者、执行耗时与校验和,version_number 唯一。 语义化版本:采用 MAJOR.MINOR.PATCH,MAJOR 为破坏性变更(删表、改列名),MINOR 为向后兼容新增(新表、可空列),PATCH 为缺陷修复、索引变更、数据迁移。 详细指南:审计追踪见 references/audit-trails.md(行版本、时态表、CDC);环境协调见 references/environment-coordination.md(多环境流程、锁);对象版本见 references/object-versioning.md(过程、视图、参考数据);迁移测试见 references/migration-testing.md(pytest 模式)。
使用方式与最佳实践:全部版本化以保证完整可追溯;历史不可变以满足审计合规;测试回滚以确保可恢复;保持环境一致;用校验和验证检测未授权变更。
限制与反模式:绝不修改已部署迁移,应新建迁移;绝不删除迁移历史,如 command.stamp(alembic_config, "head") 会丢失历史;绝不跳过环境,始终 local -> CI -> staging -> production;绝不在迁移中版本化敏感数据,如 op.bulk_insert(users, [{"password": "secret"}])。
相关技能:alembic-migrations 负责迁移实现,database-schema-designer 负责模式设计,zero-downtime-migration 负责安全的生产变更。具体定价与平台支持资料暂未提供。