Guia de referência de migrações de banco de dados do Rails

As migrações do Active Record permitem evoluir o esquema do banco de dados ao longo do tempo usando uma DSL Ruby pura, sem escrever comandos SQL DDL diretamente.

Geradores de Migração CLI

# Gerar migração para nova tabela
bin/rails g migration CreateArticles title:string body:text published:boolean

# Gerar migração para adicionar coluna
bin/rails g migration AddViewsToArticles views:integer

# Gerar tabela de junção
bin/rails g migration CreateJoinTableUsersProjects users projects

# Executar migrações pendentes
bin/rails db:migrate

# Reverter a última etapa de migração
bin/rails db:rollback STEP=1

---

Criação de Tabelas (create_table)

class CreateUsers < ActiveRecord::Migration[7.1]
  def change
    create_table :users do |t|
      t.string :name, null: false
      t.string :email, index: { unique: true }
      t.text :bio
      t.integer :login_count, default: 0
      t.decimal :balance, precision: 10, scale: 2
      t.boolean :active, default: true, null: false
      t.jsonb :preferences, default: {}

      # Chave estrangeira
      t.references :organization, null: false, foreign_key: true

      t.timestamps # Timestamps: created_at e updated_at
    end
  end
end

---

Alteração de Colunas e Tabelas

class AlterArticles < ActiveRecord::Migration[7.1]
  def change
    add_column :articles, :status, :string, default: "draft"
    remove_column :articles, :legacy_field, :string

    change_column_null :articles, :title, false
    change_column_default :articles, :views, from: nil, to: 0

    rename_column :articles, :author, :writer
    add_index :articles, [:status, :created_at]
  end
end

---

Migrações Reversíveis

def change
  reversible do |dir|
    dir.up do
      execute "CREATE EXTENSION IF NOT EXISTS citext;"
    end
    dir.down do
      execute "DROP EXTENSION IF EXISTS citext;"
    end
  end
end

---

Referências

• Guia de migrações do Active Record
• Guia de referência do Rails