更新日: 2014年2月4日
Rails

ActiveRecord 単体をインストールして sqlite3 データベースのマイグレーション

Rails の ActiveRecord のマイグレーション機能は便利なので、Rails 製でないアプリケーションでもマイグレーション機能を使いたい。ActiveRecord を単体でインストールし、Rake タスクを自作することで ActiveRecord のマイグレーション機能を利用できます。

【お知らせ】英単語を画像イメージで楽に暗記できる辞書サイトを作りました。英語学習中の方は、ぜひご利用ください！

画像付き英語辞書 Imagict | 英単語をイメージで暗記
【開発記録】
英単語を画像イメージで暗記できる英語辞書サービスを作って公開しました

— gem のバージョン —
activerecord-4.0.2
rake-10.1.1
sqlite3-1.3.8

ディレクトリ構成

ディレクトリ構成は以下の通りにします。マイグレートファイルの場所は Rails にならいました。また sqlite データベースは、database/db.sqlite に置きました。


$ mkdir app
$ cd app
$ mkdir database
$ mkdir -p db/migrate
$ touch db/migrate/001_create_tests.rb
$ touch Rakefile

$ mkdir app

$ cd app

$ mkdir database

$ mkdir -p db/migrate

$ touch db/migrate/001_create_tests.rb

$ touch Rakefile

必要な gem をインストール

今回扱ったデータベースは sqlite3 です。sqlite3, activerecord, rake の3つの gem をインストールします。


$ cd app
$ bundle init
$ vi Gemfile
source "https://rubygems.org"

gem "sqlite3"
gem "activerecord"
gem "rake"
$ bundle install --path vendor/bundle

$ cd app

$ bundle init

$ vi Gemfile

source "https://rubygems.org"

gem "sqlite3"

gem "activerecord"

gem "rake"

$ bundle install --path vendor/bundle

Rakefile を編集

Rakefile に Rakeタスクを追加します。

app/Rakefile

require 'active_record'
require 'logger'

namespace :db do
  MIGRATIONS_DIR = 'db/migrate'

  # connect the database
  ActiveRecord::Base.establish_connection(
    :adapter => 'sqlite3',
    :database => 'database/db.sqlite'
  )

  # outpt logs
  ActiveRecord::Base.logger = Logger.new(STDOUT)

  desc "Migrate the database"
  task :migrate do
    ActiveRecord::Migrator.migrate(MIGRATIONS_DIR, ENV["VERSION"] ? ENV["VERSION"].to_i : nil)
  end

  desc 'Roll back the database schema to the previous version'
  task :rollback do
    ActiveRecord::Migrator.rollback(MIGRATIONS_DIR, ENV['STEP'] ? ENV['STEP'].to_i : 1)
  end
end

require 'active_record'

require 'logger'

namespace :db do

MIGRATIONS_DIR = 'db/migrate'

# connect the database

ActiveRecord::Base.establish_connection(

:adapter => 'sqlite3',

:database => 'database/db.sqlite'

)

# outpt logs

ActiveRecord::Base.logger = Logger.new(STDOUT)

desc "Migrate the database"

task :migrate do

ActiveRecord::Migrator.migrate(MIGRATIONS_DIR, ENV["VERSION"] ? ENV["VERSION"].to_i : nil)

end

desc 'Roll back the database schema to the previous version'

task :rollback do

ActiveRecord::Migrator.rollback(MIGRATIONS_DIR, ENV['STEP'] ? ENV['STEP'].to_i : 1)

end

migration ファイルを編集

先ほど 001_create_tests.rb という名前で migrate 用のファイルを作成したので、クラス名を CreateTests とします。

db/migrate/001_create_tests.rb

class CreateTests < ActiveRecord::Migration
  def self.up
    create_table :tests do |t|
      t.string :name

      t.timestamps
    end
  end

  def self.down
    drop_table :tests
  end
end

class CreateTests < ActiveRecord::Migration

def self.up

create_table :tests do |t|

t.string :name

t.timestamps

end

def self.down

drop_table :tests

end

migrate を実行

rake タスクが正しく登録されているか確認。


$ bundle exec rake -vT
rake db:migrate   # Migrate the database
rake db:rollback  # Roll back the database schema to the previous version

$ bundle exec rake -vT

rake db:migrate # Migrate the database

rake db:rollback # Roll back the database schema to the previous version

migrate を実行して tests テーブルを作成。


$ bundle exec rake db:migrate

$ bundle exec rake db:migrate

tests テーブルが追加されているのを確認できる。

元に戻す（tests テーブルを削除）。


$ bundle exec rake db:rollback

$ bundle exec rake db:rollback

以上です。

パーフェクト Ruby on Rails は、最近読んだ Rails 本の中では一番役に立った本です。Chef や Capistrano など Rails と共によく使用される技術にも触れてあります。Ruby on Rails 4 アプリケーションプログラミングは、入門的な内容で Rails の機能全体を網羅されています。

パーフェクト Ruby on Rails

Ruby on Rails 4 アプリケーションプログラミング