Active Record Migrations 基础

前言

Migration(迁移), 其实就是Active Record对数据库结构的操作,通过Migration无需在使用SQL命令来修改数据库.使用简单的Ruby DSL 就能对数据表进行修改.

1.Migration迁移文件命名

文件位置在"db/migrate"
一个Migration文件的文件名类型如下:

YYYYMMDDHHMMSS_create_products.rb
20080906120001_add_details_to_products.rb

这两个文件名中的迁移类的名称是用驼峰式的命名规则:

# YYYYMMDDHHMMSS_create_products.rb
class CreateProducts < ActiveRecord::Migration[5.1]
end
# 20080906120001_add_details_to_products.rb
class AddDetailsToProducts < ActiveRecord::Migration[5.1]
end

2.创建Migration

2.1创建空Migration

$ rails g migration CreateUsers

这个命令会创建一个空Migration(迁移)

class CreateUsers < ActiveRecord::Migration[5.1]
  def change
    create_table :users do |t|
    end
  end
end

2.2 添加字段

email如果不指定数据类型默认为string

$ rails g migration AddEmailToUsers email

生成一个名为YYYYMMDDHHMMSS_add_email_to_users.rb的迁移
上面的命令等效于：

$ rails g migration AddEmailToUsers email:string

这个命令给users表添加一个email字段。

class AddEmailToUsers < ActiveRecord::Migration[5.1]
  def change
    add_column :users, :email, :string
  end
end

当Migration的名称为AddXXXToYYY 或RemoveXXXFromYYY 的形式时，会自动生成包含合适的 add_column 或 remove_column 语句。

2.3创建删除字段的Migration

$ rails g migration RemoveEmailFromUsers email:string

class RemoveEmailFromUsers < ActiveRecord::Migration[5.1]
  def change
    remove_column :users, :email, :string
  end
end

2.4 创建references字段类型

使用references/belongs_to生成关系

$ rails g migration AddUserRefToCompanies user:belongs_to

生成Migration文件

class AddUserRefToCompanies < ActiveRecord::Migration[5.1]
  def change
    add_reference :companies, :user, foreign_key: true
  end
end

这个Migration会在companies表里生成一个user_id字段并创建索引。

2.5创建联结表

命令中包含JoinTable

$ rails g migration CreateJoinTableCustomerProduct customer product

class CreateJoinTableCustomerProduct < ActiveRecord::Migration[5.1]
  def change
    create_join_table :customers, :products do |t|
      # t.index [:customer_id, :product_id]
      # t.index [:product_id, :customer_id]
    end
  end
end

3.运行迁移

3.1初始化数据库

在配置完config/database.yml文件的数据库信息后执行

$ rails db:setup

会根据配置文件中的配置创建数据库。

3.2 重置数据库

对应的有初始化，就有删除数据库。

$ rails db:dorp

配合rails db:setup就等同于

$ rails db:reset

3.3回滚

$ rails db:rollbacke  #回滚最后一次迁移

$ rails db:rollbacke  STEP=3 #回滚最后三次迁移

$ rails db:rollbacke:redo STEP=3  #回滚最后三次迁移并重新执行