[Rails] Active Record Migration

资料来源：Rails Guide

Guide

-使用 generator 自动生成迁移
-使用迁移创建，更改数据库模式
-使用任务执行迁移，完成数据库模式更新
-在 schema.rb 文件中查看更新后的模式

1. Definition

Migration 以一种简单的方式来不断更新你的数据库模式 (database schema)。它使用 ruby DSL 所以你不必去写那些繁琐的数据库SQL语句来更新模式，并且它是独立于某种特定的数据库 (database independent)，使用它可以作用于多个不同的数据库，当你想要换数据库时会显得特别方便。你可以把每个数据库迁移想象为一个数据库版本，schema 从什么都没有开始一点点地随着每个版本向前更新。你可以创建删除表格，添加修改列名及其属性，添加索引等等复杂的操作。Active Record 会更新你的db/schema.rb文件来匹配你最新的数据库结构。
–(1) 按照时间顺序管理数据库模式;
–(2) 对数据库的操作和所用的数据库种类无关;
–(3) 可以把每次迁移看做是数据库的一个修订版本.

2. Create Migration

通过 generator 生成迁移时遵循名字add_xxx_to_yyy, remove_xxx_from_yyy，随后跟着属性和相匹配的类型 (默认为字符串类型) (可以在类型后在指定是否要添加索引)，会在迁移中自动生成add_column, remove_column语句。同理，使用create_xxx跟着属性列表会自动生成create_table(属性列表若包含类型为references, belongs_to会生成加索引的关联，并在数据库层添加完整性验证)。
Tips: 特殊词: limit, precision, scale, polymorphic, null, default, index, comment

# migration generator examples
rails generate migration add_part_number_to_products part_number:string:index
rails generate migration add_details_to_products part_number:string price:decimal
rails generate migration create_products name:string part_number:string
rails generate migration add_user_ref_to_products user:references
rails generate migration create_join_table_customer_product customer product
rails generate migration add_details_to_products 'price:decimal{5,2}' supplier:references{polymorphic}

3. Running Migration

通过使用rake db:migrate / rake db:rollback来进行更新或回滚操作。
运行rake db:migrate任务时，会生成调用迁移中的change或up方法，随后运行rake db:schema:dump，更新与你数据库结构相匹配的db/schema.rb文件。
– 针对那些无法自动回滚的操作，我们可以使用 reversible 或者 up/down方法
– 若想修改已经运行的迁移，要先回滚到之前的状态，做修改，再运行迁移
– 若想运行指定版本的迁移(破坏顺序) rake db:migrate:up VERSION=20080906120000
– 指定目标版本会(跟新/回滚)到那个版本 rake db:migrate VERSION=20080906120000
– 若想回滚到最初版本则将目标版本设为零即可 rake db:migrate VERSION=0
– 若想回滚指定次数的迁移则通过设置STEP来达到 rake db:migrate STEP=4
– 若想回滚之后重新运行指定次数的迁移 rake db:migrate:redo STEP=3
– rake db:setup 用来创建数据库，导入数据库模式，初始化种子数据
– rake db:reset 用来删除原先数据库，再重新创建配置 drop then setup
– rake db:reset 注意是通过导入模式文件而不是重新运行迁移
– rake db:schema:dump => db/schema.rb 匹配自动生成新的数据库模式
– rake db:structure:dump => db/structure.sql 生成SQL语句的结构模式

Migration for MySQL Limit

# ActiveRecord Migrate
create_table 'example' do |t| 
  t.integer :int  # int (4 bytes, max 2,147,483,647) 
  t.integer :int, :limit => 1  # tinyint (1 byte, -128 to 127) 
  t.integer :int, :limit => 2  # smallint (2 bytes, max 32,767) 
  t.integer :int, :limit => 3  # mediumint (3 bytes, max 8,388,607)     
  t.integer :int, :limit => 4  # int (4 bytes) 
  t.integer :int, :limit => 5  # bigint (8 bytes, max 9,223,372,036,854,775,807) 
  t.integer :int, :limit => 8  # bigint (8 bytes) 
  t.integer :int, :limit => 11 # int (4 bytes)
end