|
|
|
|
データベースのスキーマ(変更)を管理する機能です。もれなくこんな特典がついてきます。
スキーマ変更は ActiveRecord::Migration のサブクラスを作って定義します。リビジョン管理していますので、各バージョン毎に1つのクラスを追加することになります。そのクラスの中で定義した up, down というクラスメソッドの内容が、それぞれアップグレードとダウングレード時の処理として実行されます。Rails では Migration 用の generator と rake コマンドが準備されていますので、さらに操作が簡単です。
up と down の定義では、スキーマ変更操作を抽象的な記述で行うことが推奨されています。これにより、(対応するDBであれば)全てのDBで同一の記述が可能になるからです。(DBIと同じ思想)。以下のスキーマ操作が利用可能です。
| 抽象表現 | Ruby型 | PostgreSQL型 | MySQL型 |
| :primary_key | Fixnum | serial primary key | int(11) DEFAULT NULL auto_increment PRIMARY KEY |
| :string | String | character varying(255) | varchar(255) |
| :text | String | text | text |
| :integer | Fixnum | integer | int(11) |
| :float | Float | float | float |
| :datetime | Time | timestamp | datetime |
| :timestamp | Time | timestamp | datetime |
| :time | Time | timestamp | datetime |
| :date | Date | date | date |
| :binary | String | bytea | blob |
| :boolean | Object | boolean | tinyint(1) |
1. 新しい Migration 定義ファイルを作成する % ruby script/generate migration my_new_migration 2. Migration の内容を定義する % vi db/migrate/1_my_new_migration.rb 3. Migration を実行する % rake migrate
既存のテーブル(members)に新しいカラム(unitcode)を追加してみましょう。
psql# \d members Column | Type | Modifiers ----------+-----------------------------+----------- code | integer | name | character varying(32) | birthday | timestamp without time zone |
今回の変更用のMigration定義ファイルを作成し、アップグレードとダウングレードの定義をします。
% ruby script/generate migration members_unitcode
create db/migrate
create db/migrate/1_members_unitcode.rb
% vi db/migrate/1_members_unitcode.rb
class MembersUnitcode < ActiveRecord::Migration
def self.up
add_column(:members, :unitcode, :integer, :default=>1)
end
def self.down
remove_column(:members, :unitcode)
end
end
Migrationを実行してみましょう。
% rake migrate
ちゃんと反映されているかどうか、スキーマを確認してみましょう。バージョン管理用の 'schema_info' というテーブルも自動的に作成されているはずです。
psql# \d members
Column | Type | Modifiers
----------+-----------------------------+-----------
code | integer |
name | character varying(32) |
birthday | timestamp without time zone |
unitcode | integer | default 1
psql# SELECT * FROM schema_info;
version
---------
2
(これ2になるんですよね。どこまで当てたかだと1を期待したんですが。次のMigrationファイルが3になっちゃうし)
先程の members テーブルを MySQL で定義する場合、Migration定義はこんな感じになるでしょう。
class AddTableMember < ActiveRecord::Migration
def self.up
options = {
:primary_key => "code", # 'id' でなくて 'code' 派なので
:options => "ENGINE=MyISAM DEFAULT CHARSET=ujis"
}
create_table(:members, options) {|table|
table.column :name , :string , :limit => 32
table.column :birthday , :datetime
}
# 初期値も入れてみる (今回の update で Member モデルが追加されてるはずなので利用)
Member.create(:name=>"夏焼雅" , :birthday=>'1992-08-25')
Member.create(:name=>"从 ’w’)", :birthday=>'1992-11-20')
...
end
def self.down
drop_table :members
end
end
mysql> describe members; +----------+-------------+------+-----+---------+----------------+ | Field | Type | Null | Key | Default | Extra | +----------+-------------+------+-----+---------+----------------+ | code | int(11) | | PRI | NULL | auto_increment | | name | varchar(32) | YES | | NULL | | | birthday | datetime | YES | | NULL | | +----------+-------------+------+-----+---------+----------------+
DBの透過性のために抽象的な操作命令で記述していましたが、直接SQLを記述することも可能です。既存の操作では表現不可能なより高度なクエリを実行する場合などに役立ちます。execute (ActiveRecord::Base.connection.execute) でSQLを直接実行します。(最悪、ここで普通に CREATE TABLE ... を書くのもありかも)。
class AddUpdateTrigger < ActiveRecord::Migration
def self.up
execute(<<-SQL)
create function f_recorded_upd() returns trigger as '
begin
new.min := extract(epoch from new.stop-new.start)/60;
new.date := case when extract(''hour'' from new.start) < 5 then
to_char(new.start - interval ''1 day'', ''YYYYMMDD'') else
to_char(new.start, ''YYYYMMDD'') end;
return new;
end;
' language 'plpgsql';
create trigger recorded_upd before insert or update on recorded for each row
execute procedure f_recorded_upd();
SQL
end
def self.down
execute(<<-SQL)
drop trigger recorded_upd on recorded cascade;
drop function f_recorded_upd();
SQL
end
end
( ActiveRecord::Base.connection.execute で任意のクエリが実行できたんですね。勉強になるなぁ)
スキーマ変更以外の用途にも利用できます。例えば、明らかにおかしいメールアドレスのデータは削除することになった場合。
class ValidateEmail < ActiveRecord::Migration
def self.up
Users.find(:all).each do |user|
user.destroy unless user.email.include?('@')
end
# エントリ数が多いと地獄なので本番では execute でクエリ書きそうだけど...
end
def self.down
# これは戻せなくてよいので無視
end
end
从’w’) ＜複数のMigrationを一気に実行するとき適用の順番は大丈夫なのかな？
ﾉﾉl∂_∂'ﾙ ＜作った順番で定義ファイルの先頭が数値付けされてるから大丈夫よ。
川 ´・_・｀ﾘ ＜逆に、好きな順番に入れ替えたりマージしたりもできるんですね。
州*‘ o‘ﾘ ＜番号を直接いじったら schema_info の version との不整合は自己責任でね。
从oTーT从＜あうぁ〜、え〜お〜あ〜
ﾉﾉl∂_∂'ﾙ ＜テーブルおかしくなったのね。もう泣かないの。rake migrate VERSION=5 とかで rollback できるから。
从’w’) ＜Migration定義ファイルの頭の数値を VERSION で指定すればいいんだね！
从 ´∇｀从＜ちなみに、rake migrate VERSION=0 で一番最初の状態に戻れますよー。
从oTーT从＜あうぁ〜、お〜あ〜お〜
ﾉﾉl∂_∂'ﾙ ＜production に反映させたいのね。rake environment RAILS_ENV=production migrate で指定可能よ。
ﾙ ��-��ﾘ ＜抽象表現でテーブル定義してたら、development は PostgreSQL で production は MySQL てのも楽だな。
（´(ｴ)｀）ｲ ＜.｡oO(そんな変態プレイはおめーだけだよ。このパンツ丸出しアイドルが！)
从’w’) ＜デレデレ!!シンデレLOVE!!クゥーン♪クゥーン♪
| JRuby | Rails | Berryz | ℃-ute | エッグ | jQuery |
| 前 | 2005年 8月 |
次 | ||||
| 日 | 月 | 火 | 水 | 木 | 金 | 土 |
| 1 | 2 | 3 | 4 | 5 | 6 | |
| 7 | 8 | 9 | 10 | 11 | 12 | 13 |
| 14 | 15 | 16 | 17 | 18 | 19 | 20 |
| 21 | 22 | 23 | 24 | 25 | 26 | 27 |
| 28 | 29 | 30 | 31 | |||
最近、Migrationにはまってます。<br>ちなみに、ベリの夏焼雅ちゃんが登場！なごみますねぇ・・^^;雅ちゃんは、1992-08-25なんですね^^;