Ruby on Rails中为命名空间模型重命名数据库表的最佳实践

通用零停机最佳实践（符合strong migrations要求） #

如果是高频率使用的表，严格遵循strong migrations给出的步骤，同时配合模型命名空间调整：

• 1. 创建新的命名空间模型及对应新表，完整复制旧表的字段、索引与约束
• 2. 修改代码逻辑，让所有写入操作同时作用于新旧两张表（可通过模型回调、统一服务层实现）
• 3. 编写脚本从旧表批量同步数据到新表（400条数据可直接在迁移中完成）
• 4. 将所有读取操作切换至新的命名空间模型
• 5. 停止对旧模型、旧表的写入操作
• 6. 删除旧模型与旧表
• 7. 确认新命名空间模型的表名配置正确

针对低频率小数据场景的简化方案 #

由于你的表使用频率极低、仅含400条记录，可采用更高效的简化方案：

方案一：维护模式下直接重命名 #

• 提前准备命名空间后的模型文件（例如app/models/admin/notification.rb，类名Admin::Notification），暂时指定旧表名：self.table_name = "notifications"
• 将应用切换到维护模式，阻断外部请求，确保无新数据写入旧表
• 创建迁移文件执行重命名：

  class RenameNotificationsToAdminNotifications < ActiveRecord::Migration[7.0]
    def change
      rename_table :notifications, :admin_notifications
      # 同步调整索引/外键名称（可选，不影响功能但更规范）
      rename_index :admin_notifications, "index_notifications_on_user_id", "index_admin_notifications_on_user_id"
    end
  end
  

• 更新命名空间模型的表名配置（若Rails自动命名规则匹配，比如Admin::Notification默认对应admin_notifications，可省略此步骤）
• 测试相关功能，确认新表读写正常
• 关闭维护模式，恢复应用运行

方案二：无停机简化切换 #

• 先创建命名空间后的模型，让新旧模型均指向旧表，同时将代码中所有新的读写逻辑切换至新模型
• 等待1-2个业务周期（如一天），通过日志确认旧模型无调用记录
• 执行表重命名迁移，同步更新新模型的表名配置
• 删除旧模型文件，清理遗留的旧模型引用

注意事项 #

• 迁移前务必备份数据库，避免数据丢失
• 所有操作先在测试环境验证通过后再部署至生产
• 若表存在外键关联，需先暂时移除外键，重命名表后重新创建关联外键

内容的提问来源于stack exchange，提问作者Emil Ståhl Myllyaho