Piccolo ORM 表迁移实战：安全地将表从一个应用移动到另一个应用

在数据库开发过程中，随着业务逻辑的演进，我们经常需要调整数据模型的组织结构。本文将详细介绍如何在 Piccolo ORM 中安全地将表从一个应用迁移到另一个应用，同时确保数据完整性不受影响。

迁移背景与挑战

在 Piccolo ORM 的项目结构中，表通常被组织在不同的应用(app)中。当发现某个表更适合放在另一个应用时，直接移动表定义文件可能会导致数据库认为原表被删除而新表被创建，从而造成数据丢失。

安全迁移四步法

第一步：移动表定义文件

首先将目标表(如 TableA)的模型定义文件从原应用(app_a/tables.py)移动到目标应用(app_b/tables.py)。这一步只是代码层面的重组，尚未涉及数据库变更。

第二步：生成自动迁移文件

为两个应用分别生成迁移文件：

piccolo migrations new app_a --auto
piccolo migrations new app_b --auto

此时 Piccolo 会检测到 app_a 中缺少了 TableA，而 app_b 中新增了 TableA。

第三步：标记迁移为假执行(Fake)

为了避免实际执行删除和创建表的操作，我们需要将这两个迁移标记为"fake"：

piccolo migrations forwards app_a --fake
piccolo migrations forwards app_b --fake

这样 Piccolo 会记录迁移已经完成，但实际上不会对数据库做任何修改。

第四步：执行迁移

最后正常执行迁移，使迁移状态与数据库同步：

piccolo migrations forwards app_a
piccolo migrations forwards app_b

技术原理

这种迁移方式利用了 Piccolo ORM 的"假迁移"特性，它允许我们：

1. 保持数据库表结构不变
2. 更新 ORM 的元数据信息
3. 维护迁移历史的完整性

通过这种方式，我们实现了表在应用间的逻辑迁移，而物理数据库结构保持不变，确保了数据安全。

最佳实践建议

1. 在执行迁移前，建议先备份数据库
2. 可以在开发环境先测试迁移流程
3. 对于大型表，可以考虑在低峰期执行迁移
4. 迁移完成后，应验证应用功能是否正常

这种表迁移技术在项目重构、微服务拆分等场景下非常有用，帮助开发者灵活调整数据模型的组织结构而不影响生产数据。