迁移是以一致和轻松的方式按时间顺序修改数据库模式的实用方法。它使用 Ruby DSL,因此不必手动编写 SQL,从而实现了数据库无关的数据库模式的创建和修改。
通过一个个迁移来添加或删除数据表、字段和记录。 Active Record 知道如何沿着时间线更新数据库模式,使其从任何历史版本更新为最新版本。Active Record 还会更新 db/schema.rb 文件,以匹配最新的数据库结构。
这个迁移用于添加 products 数据表,数据表中包含 name 字符串字段和 description 文本字段。同时隐式添加了 id 主键字段,这是所有 Active Record 模型的默认主键。timestamps 宏添加了 created_at 和 updated_at 两个字段。后面这几个特殊字段只要存在就都由 Active Record 自动管理。
如果想在迁移中完成一些 Active Record 不知如何撤销的操作,可以使用 reversible 方法或者用 up 和 down 方法来代替 change 方法:
不需要计算时间戳,Active Record 提供了生成器:
在新建字段上添加索引:
删除字段的迁移:
修改数据表:下面的代码删除 description 和 name 字段,创建 part_number 字符串字段并添加索引,最后重命名 upccode 字段。
修改字段
字段修饰符
limit 修饰符:设置 string/text/binary/integer 字段的最大长度。
precision 修饰符:定义 decimal 字段的精度,表示数字的总位数。
scale 修饰符:定义 decimal 字段的标度,表示小数点后的位数。
polymorphic 修饰符:为 belongs_to 关联添加 type 字段。
null 修饰符:设置字段能否为 NULL 值。
default 修饰符:设置字段的默认值。请注意,如果使用动态值(如日期)作为默认值,那么默认值只会在第一次使时(如应用迁移的日期)计算一次。
index 修饰符:为字段添加索引。
comment 修饰符:为字段添加注释。
如果 Active Record 提供的辅助方法不够用,可以使用 excute 方法执行任意 SQL 语句:
使用 change 方法
运行迁移
Rails 提供了一套用于运行迁移的 bin/rails 任务。其中最常用的是 rails db:migrate 任务,用于调用所有未运行的迁移中的 chagne 或 up 方法。如果没有未运行的迁移,任务会直接退出。调用顺序是根据迁移文件名的时间戳确定的。执行 db:migrate 任务时会自动执行 db:schema:dump 任务,这个任务用于更新 db/schema.rb 文件,以匹配数据库结构。如果指定了目标版本,Active Record 会运行该版本之前的所有迁移
回滚
回滚最后一个迁移
撤销最后三个迁移
运行或撤销指定迁移
在不同环境中运行迁移