Rails migrations: self.up and self.down versus change

Question

Looks like the new rails version has "change" versus self.up and self.down methods.

So what happens when one has to roll back a migration how does it know what actions to perform. I have the following method that I need to implement based on an online tutorial:

class AddImageToUsers < ActiveRecord::Migration
  def self.up
    add_column :users, :image_file_name, :string
    add_column :users, :image_content_type, :string
    add_column :users, :image_file_size, :integer
    add_column :users, :image_updated_at, :datetime
  end

  def self.down
    remove_column :users, :image_file_name, :string
    remove_column :users, :image_content_type, :string
    remove_column :users, :image_file_size, :integer
    remove_column :users, :image_updated_at, :datetime
  end    
end

How can I do the same using the new change method?

http://guides.rubyonrails.org/migrations.html#using-the-change-method — Baldrick, Apr 28 '12 at 15:57

Aldo 'xoen' Giambelluca · Accepted Answer · 2012-04-28T17:01:26.240

For many operations rails can guess what is the inverse operation (without problems). For example, in your case what is the reverse operation of add_column to call when you rollback? Of course it's remove_column. What is the inverse of create_table? It's drop_table. So in these cases rails know how to rollback and define a down method is superfluous (you can see in the documentation the methods currently supported from the change method).

But pay attention because for some kind of operation you still need to define the down method, for example if you change the precision of a decimal column how to guess the original precision on rollback? It's not possible, so you need to define the down method.

As said, I suggest you to read the Rails Migrations Guide.

score 36 · Answer 2 · answered Sep 28 '15 at 10:24

36

Better to use Up, Down, Change:

On Rails 3 (Reversible): which should add new column on up and fill all records in table only on up, and only delete this column on down

def up
  add_column :users, :location, :string
  User.update_all(location: 'Minsk')
end

def down
  remove_column :users, :location
end

But:

You had to avoid using change method which allows to save some time. For example, if you didn’t need to update column value immediately after it’s adding you would cut this code down to like this:

def change
  add_column :users, :location, :string
end

On up it will add column to table and remove it on down. Much less code and it’s a profit.

On Rails 4: one more useful way to write what we need in one place:

def change
  add_column :users, :location, :string
  reversible do |direction|
    direction.up { User.update_all(location: 'Minsk') }
  end
end

answered Sep 28 '15 at 10:24

Kaleem Ullah

6,799
3
42
47

1

Nice explanation bro – Bibek Sharma Jan 30 '16 at 09:05
reverting? is also a good way to tell the direction you're going inside the change – baash05 Feb 25 '16 at 05:01
None of this works. I just keep getting `ActiveRecord::IrreversibleMigration`. – Throw Away Account May 09 '17 at 18:38
there are situations where rails fail to rollback migration. please view their [help](http://api.rubyonrails.org/classes/ActiveRecord/IrreversibleMigration.html) – Kaleem Ullah May 10 '17 at 05:29

score 1 · Answer 3 · answered Apr 28 '12 at 15:58

1

class AddImageToUsers < ActiveRecord::Migration
  def change
    add_column :users, :image_file_name, :string
    add_column :users, :image_content_type, :string
    add_column :users, :image_file_size, :integer
    add_column :users, :image_updated_at, :datetime
  end
end

answered Apr 28 '12 at 15:58

nothing-special-here

11,230
13
64
94

Thanks.but what would happen if you were to roll back. would it know what to do? – banditKing Apr 28 '12 at 16:01
3

I overslept. Aldo 'xoen' Giambelluca explain everything. – nothing-special-here Apr 30 '12 at 18:07

Rails migrations: self.up and self.down versus change

3 Answers3

Linked

Related