`
yangzhihuan
  • 浏览: 168759 次
  • 性别: Icon_minigender_1
  • 来自: 广州
社区版块
存档分类
最新评论

Migrations流水帐

阅读更多
对于Rails的迁移功能Migrations,一直都只是看一下网上的一些很基础很基础的代码片断就开始动手写代码,对它的认识基本上就是停留在抄袭的层面,连会用都说不上.有感于此,终下决心要弄清楚Migrations,至少得会用啊,山寨抄袭终非王道.

学习Migrations最佳的学习资料莫过于 Ruby On Rails网站上的 Guides 系统文章了,链接在 http://guides.rubyonrails.org/migrations.html
本文的很多代码都是出自那里.

在我的理解中,Migrations就是一个基于ruby,针对数据库(SQL)的DSL,它的出现也是符合Rails中处处皆Ruby的原则的,正是专注于Ruby,这样Rails才显得别样的美丽.

=========================== 如何写migration =========================


    1.migration的结构

每一个migrate的类都是 ActiveRecord::Migration 的子类,每一个migrate都要重写两个方法 up 和 down:
class CreateProducts < ActiveRecord::Migration 
  def self.up 
     #想干嘛,就干嘛
   end  
   def self.down 
      #你后悔的时候,你会怎么做? 
    end 
end 

简单的说 up 方法就是操作数据库时用的,down就是你后悔了,用来回滚用的.


    2.migration提供调用的方法

Migrations提供了一系列的方法来操作数据库:
     create_table  #建表
     change_table  #修改表结构
     drop_table    #删除表
     add_column    #增加字段
     change_column #修改字段定义
     rename_column #修改字段名
     remove_column #删除字段
     add_index     #创建索引
     remove_index  #删除索引

具体各个方法的详细定义,可以查看Rails的API http://api.rubyonrails.org/classes/ActiveRecord/Migration.html
这些方法替代使用SQL来操作数据库,当然也可以使用 execute 方法直接使用 SQL 来操作数据库,个人不推荐这种方式,但是在某些情况下,提供直接使用SQL也是很方便的:
execute <<-SQL 
ALTER TABLE products ADD CONSTRAINT fk_products_categories FOREIGN KEY (category_id)  REFERENCES categories(id)  
SQL 



    3.字段

定义字段有两种方法:
#这个是传统的方法
create_table :products do |t| 
t.column :name, :string, :null => false 
end 

#这个刚出来的时候,大家都说很性感,其实不外乎就是定义一系列的快捷方法: string,
# text, integer, float, decimal, datetime, timestamp, time, date,
# binary, boolean . 这一系列的方法对应各种数据类型,
# 还有 primary_key 方法是用来定义主键的.
create_table :products do |t| 
t.string :name 
end 

除了这几个经典的定义字段方法外,还有两个特别的Helper方法:
#以下这个方法会自动在表中增加 created_at,updated_at这两个类型为timestamp的字段
change_table :products do |t| 
t.timestamps 
end 

#这个方法是定义关于关系的,但是不会为你的表加上外键约束,如果你加上约束,请另外手动添加,切记!
create_table :products do |t| 
t.references :category # 生成 category_id

#这个是关联关系中多态的定义,生成两个字段 attachment_id 和 attachment_type ,并且attachment_type的默认值为 'Photo'
t.references :attachment, :polymorphic => {:default => 'Photo'} 
end 

以上两个方法是锦上添花之作,相当的实用.


    4.在migration中使用 Model

除了使用以上方法操作数据库外,其实还可以直接在migration中使用 Model 的.比如:
def self.up
#直接就用model来更新数据库,
#你可以看到 migration 一直在提供便利让你避免使用SQL,当然不是说SQL不好,只是想让你更加的统一,只要ruby就好了.  
User.update_all ["receive_newsletter = ?", true] 
end 


使用model的另外一种情况是:当前migration要删除表中的一个字段 first_name,但是你的model中的某个方法使用了这个字段作为验证,比如:
class User < ActiveRecord::Base
    validates_presence_of :first_name
end

那么当你要在migration中增加一条记录时,这个验证便不能通过,如:
def self.up 
User.create({:name => 'name'}).save 
end 

在这种情况下,你可以在migration中重新定义一个model:
class XXXMigration < ActiveRecord::Migration 
class User < ActiveRecord::Base 
end
def self.up
remove_column :first_name
end

#这个方法的作用就是取得最新的表定义
User.reset_column_information 
#放心吧,这个User不会有 validates_presence_of :first_name 的验证
User.create({:name => 'name'}).save


=========================== migration文件的命名 =======================

按照Migration的约定去命名你的migration文件,会令你省不少功夫的,请千万要相信这一点.
如果migration文件名是这样的格式: AddXXXToYYY” or “RemoveXXXFromYYY
XXX => 字段名, YYY => 表名.
那么migration生成的时候,Rails会自动为你加上 add_column or remove_column
比如:
#留意类名
class AddPartNumberToProducts < ActiveRecord::Migration 
def self.up 
add_column :products, :part_number, :string  
end  
def self.down 
remove_column :products, :part_number  
end 
end 

class RemovePartNumberFromProducts < ActiveRecord::Migration 
def self.up 
remove_column :products, :part_number  
end  
def self.down 
add_column :products, :part_number, :string  
end 
end 

cool吧??

=========================== 如何执行migration =========================

执行migration的经典方法:
rake db:migrate

#执行特定版本
rake db:migrate VERSION=20080906120000 

#屏蔽migration的输出
rake db:migrate VERBOSE=false

#你又后悔,可以用如下方法回滚到最近的一次migration执行的状态
rake db:rollback 

#回滚到最近的3次,题外话,关于这个STEP=3到底是保存在那里的,我不曾找到,在数据库的schema_migrations表中,只有版本的信息
#莫非是按schema_migrations表记录的顺序?这个还要验证一下.
rake db:rollback STEP=3


=========================== 导出migration =========================

在某些时候,你可能需要导出migration对数据库表的字义,可以导出的格式有 rb 和 sql文件两种,前一种是正宗的ruby文件,后一种是对应你使用的数据库的SQL文件.

rb:大家都知道要查看某个model的属性时,只能去db/migrate中找定义文件,但是有了这个migration的定义文件后,只要打开它就能看了.
sql:很多时候,程序员是没有权限操作数据库的,或者没有ruby环境,这时候导出的sql定义文件就有用了.

至于你需要那一种,可以配置一下 config/environment.rb
config.active_record.schema_format => :sql # or :rb


然后执行:
rake db:structure:dump

到 RAILS_ROOT/db 目录下看看吧.

==================================================================

写完了,其实这里没有多少我的东西,大部分出自 http://guides.rubyonrails.org/migrations.html ,我只不过把英文变成中文罢了.
分享到:
评论
20 楼 rainchen 2009-09-15  
Rails 2.3.4 内置了seed,只是这个只是导入的方案,自动生成seed代码怎么办?自己写个seed代码生成task?更需要懒人方案
19 楼 poshboytl 2009-09-15  
呵呵..Rails guide做得不错...弥补了当年文档不够好(相对Django)的缺陷....  写Rails guide有奖金哦...谁有兴趣试过?
18 楼 poshboytl 2009-09-15  
如果数据还要.... 我的做法通常都是在数据库级别做...
mysql 下用dump还是很方便的....

17 楼 rainchen 2009-09-15  
对了,现在数据导出导入有什么较好的做法没,比如在dev时生成了一些数据,打算以后导入到production环境中用
16 楼 orcspirit 2009-09-14  
学习了
我现在用一点测试数据,偶尔迁移下,用的命令是:
dropdb XXX -U postgres
createdb XXX -U postgres
rake db:migrate
15 楼 不是流氓 2009-08-15  
现在的做法都是把备用数据写成rake脚本,出现问题的时候直接drop掉db,再create,
保证数据库里面的数据是最干净的
14 楼 yangzhihuan 2009-08-14  
netfork 写道
netfork 写道
再来补充一下这个贴子,发现下面的在开发阶段也用的很多:
db:migrate:down VERSION=9999999999


NetBeans真的是很绝!






Netbeans 确实是功能强劲,不过一般都是在终端下执行rails命令行,netbeans专门用来写代码就好了.
13 楼 Hooopo 2009-08-14  
gokure 写道
还可以在migration文件里使用自定义helper,helper文件可以放到lib目录下
使用extend加载外部helper
附上一个添加移除外键的代码
初学rails,代码拙了点
module MigrationHelpers
  # Add foreign key for migrations
  # Usage:
  # * /db/migrate/xxxx_create_users.rb
  # class CreateUsers < ActiveRecord::Migration
  #   extend MigrateionHelpers
  #   def self.up
  #     ...
  #     add_foreign_key :users, :group_id :groups
  #   end
  #   def down.up
  #     ...
  #     remove_foreign_key  :users, :group_id
  #   end
  # end
  #
  
  def add_foreign_key(from_table, from_column, to_table, to_column = 'id')
    constraint_name = "fk_#{from_table}_#{from_column}"
    execute "ALTER TABLE #{from_table} ADD CONSTRAINT #{constraint_name} FOREIGN KEY (#{from_column}) REFERENCES #{to_table} (#{to_column})"
  end
  
  def remove_foreign_key(from_table, from_column)
    constraint_name = "fk_#{from_table}_#{from_column}"
    execute "ALTER TABLE #{from_table} DROP CONSTRAINT #{constraint_name}"
  end
end

有两个问题:
1,rails 里需要自己指定外键吗?
2,你这样写在helper 里面和script/generate migration add_fk 比的好处在哪?
12 楼 netfork 2009-08-14  
netfork 写道
再来补充一下这个贴子,发现下面的在开发阶段也用的很多:
db:migrate:down VERSION=9999999999


NetBeans真的是很绝!




11 楼 netfork 2009-08-14  
再来补充一下这个贴子,发现下面的在开发阶段也用的很多:
db:migrate:down VERSION=9999999999
10 楼 gokure 2009-07-14  
还可以在migration文件里使用自定义helper,helper文件可以放到lib目录下
使用extend加载外部helper
附上一个添加移除外键的代码
初学rails,代码拙了点
module MigrationHelpers
  # Add foreign key for migrations
  # Usage:
  # * /db/migrate/xxxx_create_users.rb
  # class CreateUsers < ActiveRecord::Migration
  #   extend MigrateionHelpers
  #   def self.up
  #     ...
  #     add_foreign_key :users, :group_id :groups
  #   end
  #   def down.up
  #     ...
  #     remove_foreign_key  :users, :group_id
  #   end
  # end
  #
  
  def add_foreign_key(from_table, from_column, to_table, to_column = 'id')
    constraint_name = "fk_#{from_table}_#{from_column}"
    execute "ALTER TABLE #{from_table} ADD CONSTRAINT #{constraint_name} FOREIGN KEY (#{from_column}) REFERENCES #{to_table} (#{to_column})"
  end
  
  def remove_foreign_key(from_table, from_column)
    constraint_name = "fk_#{from_table}_#{from_column}"
    execute "ALTER TABLE #{from_table} DROP CONSTRAINT #{constraint_name}"
  end
end
9 楼 秦汉唐宋明 2009-07-13  
一直觉得rails的guide是最好的教程,投精华了。
8 楼 rainchen 2009-07-13  
我用得较多的
rake db:rollback
7 楼 yangzhihuan 2009-07-13  
刑天战士 写道
投新手了,这帖子不应该在这里出现


呵呵... 其实就是用自己的语言翻译了一下,一来可以在自己想用的时候查一查,发出来是希望对新学习Rails的同学能有所帮助.
6 楼 yangzhihuan 2009-07-12  
QuakeWang 写道
补充一个在开发阶段很常用的命令redo:
rake db:migrate:redo
rake db:migrate:redo STEP=3


我没用过这几个命令,所以没写上.
5 楼 gakaki 2009-07-12  
推荐2个库一个是heroku开发的

yaml db作用是把数据导出成yml 这样就可以轻松的在sqlite mysql等多种数据库之间切换
http://github.com/search?q=yaml&type=Repositories&x=22&y=25



另一个就是生成测试数据的

http://railscasts.com/episodes/126-populating-a-database


4 楼 netfork 2009-07-12  
学习了,投良好了。
3 楼 刑天战士 2009-07-12  
投新手了,这帖子不应该在这里出现
2 楼 QuakeWang 2009-07-12  
补充一个在开发阶段很常用的命令redo:
rake db:migrate:redo
rake db:migrate:redo STEP=3
1 楼 下一站,火星 2009-07-11  
migration在以Oracle为数据库的时候,安全性需要慎重一下,鄙人出现过,在迁移过程中,清空的数据库的悲惨经历

相关推荐

    MySQL Migration Toolkit免安装版

    MySQL Migration Toolkit是一款强大的工具,专为数据库管理员和开发人员设计,用于将各种其他数据库系统的数据迁移到MySQL。这款免安装版本使得用户无需正式安装即可直接使用,方便快捷。以下是关于MySQL Migration ...

    ESF Database Migration Toolkit

    **ESF Database Migration Toolkit** 是一款专业的数据迁移工具,它具备强大的功能,支持在多种主流数据库之间进行数据迁移。这款工具能够帮助用户轻松地将数据从一个数据库系统迁移到另一个,比如MySQL、Oracle、...

    MySQL Migration Toolkit 数据库转化工具下载

    MySQL Migration Toolkit是一款强大的数据库迁移工具,它为用户提供了将数据从其他数据库系统迁移到MySQL的便利。这款2.3版本的工具集成了多种功能,旨在简化数据库迁移过程,确保数据的完整性和一致性。 1. **简介...

    IBM Migration Toolkit

    **IBM Migration Toolkit** 是一款由IBM提供的专业数据迁移工具,旨在帮助用户轻松地在不同的数据库系统之间进行数据源迁移。这款工具支持多种数据库平台,包括SQL Server、MySQL、Oracle以及DB2,使得在这些数据库...

    使用 IBM DB2 Migration Toolkit 迁移数据

    ### 使用 IBM DB2 Migration Toolkit 迁移数据 #### 背景介绍 随着技术的发展,企业经常需要在不同的数据库系统之间迁移数据。IBM DB2 Migration Toolkit (MTK) 是一款强大的工具,它可以帮助用户轻松地将数据从...

    ESF Database Migration Toolkit 9.x 64位补丁

    ESF Database Migration Toolkit 是一个允许您在不同数据库格式之间进行数据转换的程序。 它可以直接连接到MySQL,SQL Server, PostgreSQL,Oracle,Access,Excel,Paradox,Lotus,dBase,Visual FoxPro,Text等...

    MySQL Migration Toolkit 数据库转换工具

    MySQL Migration Toolkit 可以将任何数据源转换成mysql的数据,也可以将mysql的数据转换成其它类型的数据 MySQL Migration Toolkit 包括下列转换工具: Access-to-MySQL Access数据库转MySQL数据库 DBF-to-MySQL DBF...

    Live_Migration虚拟化实战

    ### Live_Migration虚拟化实战知识点解析 #### 一、Live Migration 概述 - **定义**: Live Migration(实时迁移)是指在不影响虚拟机运行的情况下,将其从一台物理服务器迁移到另一台物理服务器上的过程。 - **...

    jakartaee-migration-1.0.0

    tomcat升级为10.x版本以后,由于JavaEE更名为Jakarta,原有的javax.*命名空间迁移为jakarta.x,原有项目如需迁移到...jar jakartaee-migration-0.2.0.jar &lt;source&gt; 命令,将新生成的war包放到webapps下即可正常使用

    多数据库迁移工具 dbMigration .NET v1.0

    dbMigration .NET 是个简单,易用,直观的多数据库迁移工具。通过 DBMigration .NET 可以在不同数据库之间轻松迁移模式和数据,不需要经过复杂的程序处理。当前支持的数据库:PostgreSQL, SQL Server, SQL Azure, ...

    数据库迁移 ESF Database Migration 7.3 破解版

    ESF.Database.Migration.Toolkit.v7.3.27 破解版 数据库迁移好工具,支持多种数据库,oracle postgresql mysql等 win7 64 位 亲测可用

    ibm DB2 migration toolkit

    【IBM DB2 Migration Toolkit】是IBM提供的一款强大的数据库迁移工具,专为帮助用户从其他数据库系统,如Oracle、SQL Server等迁移到DB2数据库而设计。这个工具集旨在简化迁移过程,减少潜在风险,提高迁移效率,...

    数据库转换神器 ESF Database Migration Toolkit - Professional

    **ESF Database Migration Toolkit - Professional** 是一款专为数据库转换设计的强大工具,它为企业级用户提供高效、稳定且灵活的数据迁移解决方案。这款软件支持多种数据库系统,包括但不限于MySQL、Oracle、SQL ...

    ESF Database Migration Toolkit Pro 8.2.07 + Key.tgz

    《ESF Database Migration Toolkit Pro 8.2.07 数据库迁移神器详解》 在数字化时代,数据库迁移是一项至关重要的任务,确保业务连续性并优化系统性能。ESF Database Migration Toolkit Pro 8.2.07 正是这样一款专为...

    ESF.Database.Migration.Toolkit.Professional.Edition

    ESF Database Migration Toolkit是一款數據庫遷移工具,支援如下數據庫和文件 系統的遷移:Oracle, MySQL, SQL Server, PostgreSQL, IBM DB2, Visual Foxpro, SQLite, FireBird, InterBase, Microsoft Access, ...

    Oracle SQLDeveloper Migration Workbench(MySQL to Oracle)

    ### Oracle SQL Developer Migration Workbench (MySQL to Oracle) #### 概述 随着企业信息化建设的不断深入,数据库迁移已经成为一种常见的需求。特别是在不同数据库系统之间的数据迁移过程中,如何保证数据的...

    从sql server完美迁移到MySql-使用Migration Wizard

    首先,根据文档标题和描述,我们可以明确这篇指南主要讲述了如何使用MySQL Workbench中的Migration Wizard工具来实现从Microsoft SQL Server到MySQL的数据库迁移。Migration Wizard是一个图形化的工具,它能够指导...

    mysql数据库移植工具(MySQL.Migration.Toolkit.v2.3)

    MySQL数据库移植工具(MySQL.Migration.Toolkit.v2.3)是一款专为数据库迁移设计的强大软件,主要功能在于实现不同数据库系统间的数据迁移,包括从其他数据库系统迁移到MySQL以及从MySQL迁移到其他数据库系统。...

    解决MySQL Migration Toolkit导入乱码

    ### 解决MySQL Migration Toolkit导入乱码问题 在数据库迁移过程中,字符集编码不一致往往会导致乱码问题出现,尤其是在从MS SQL Server向MySQL进行数据迁移时。本文将详细介绍如何使用MySQL Migration Toolkit解决...

Global site tag (gtag.js) - Google Analytics