Active Record 迁移
huruji opened this issue · comments
编写迁移
使用 create_table 方法创建数据表
create_table :products do |t|
t.string :name
end
create_table
是最基础的、最常用的方法,通常由生成器生成,默认情况下,这个方法会自动创建 id
字段, 可以使用 id: false
来禁用主键,可以使用 :primary_key
来修改主键名称,如果需要传递数据库特有的选项,可以在 :options
选项中使用SQL代码
create_table :products, options: "ENGINE=BLACKHOLE" do |t|
t.string :name, null: false
end
使用 create_join_table 创建联结数据表
create_join_table :products, :categories
这会创建包含 category_id
和 product_id
字段的 categories_products
数据表,这两个字段的 :null
选项默认设置为 false
,可以通过 :column_options
选项覆盖这一设置:
create_join_table :products, :categories, column_options: {null: true}
需要说明的是数据表的名称默认由前两个参数按字母顺序组合而来,可以传入 :table_name
选项来自定义数据表名称:
create_join_table :products, :categories, table_name: :categorization
这个方法也接受块作为参数,用于添加索引或附加字段。
使用change_table修改数据表
change_table
与 create_table
方法非常类似,用于修改现有的数据表,风格类似,但是传入的快对象有更多的用法。
change_table :products do |t|
t.remove :description, :name
t.string :part_number
t.index :part_number
t.rename :upccode, :upc_code
end
修改字段
Rails 提供了与 remove_column
和 add_column
类似的 change_column
迁移方法。
change_column :products, :part_number, :text
这里的代码把 products 数据表的 :part_number
字段修改为 :text
字段,需要注意的是 change_column
命令是无法撤销的。
除此之外,还有 change_column_null
和 change_column_default
方法,分别用于设置字段是否可为空、修改字段的默认值。
change_column_null :products, :name, false
change_column_default :products, :approved, from: true, to: false
作用是将products数据表的 :name
字段设置为 NOT_NULL,把 :approved
字段的默认值由
true
改为 false
。
字段修饰符
字段修饰符可以在创建或修改字段时使用,有 limit
precision
scale
polymorphic
null
default
index
comment
外键
使用外键约束可以保证引用的完整性,方法有 add_foreign_key
和 remove_foreign_key
执行SQL语句
如果 Active Record 提供的辅助方法不够用,可以使用 excute
方法执行任意的SQL语句
Product.connection.execute("UPDATE products SET price = 'free' WHERE id = 1")
使用change方法
change方法是编写迁移时最常用的,change方法中只能使用以下方法:
-
add_column
-
add_foreign_key
-
add_index
-
add_reference
-
add_timestamps
-
change_column_default
-
change_column_null
-
create_join_table
-
create_table
-
disable_extension
-
drop_join_table
-
drop_table
-
enable_extension
-
remove_column
-
remove_foreign_key
-
remove_index
-
remove_reference
-
remove_timestamps
-
rename_column
-
rename_index
-
rename-table
运行迁移
最常用的迁移命令就是 rails db:migrate
命令,这个方法会调用所有未运行的change或者up方法,调用的顺序是根据迁移文件名的时间戳确定的。
运行这个命令时会自动执行 db:schema:dump
任务,这个任务用于更新 db/schema.rb
文件,以匹配数据库结构。
可以指定目标版本进行迁移
rails db:migrate VERSION=20080906120000
版本号是时间戳,这是向上迁移,但包括指定的版本。
回滚迁移
rails db:rollback
这会回滚最后一个迁移
如果需要取消多个迁移任务可以使用STEP参数:
rails db:rollback STEP=3
使用 db:migrate:redo
可以回滚并重新运行这个迁移,同样可以使用STEP参数
rails db:migrate:redo STEP=3