Las migraciones de Active Record permiten evolucionar el esquema de la base de datos a lo largo del tiempo utilizando un DSL en Ruby puro sin escribir SQL DDL directamente.
Generadores CLI de Migraciones
# Generar migración para una nueva tabla
bin/rails g migration CreateArticles title:string body:text published:boolean
# Generar migración para añadir una columna
bin/rails g migration AddViewsToArticles views:integer
# Generar tabla de unión
bin/rails g migration CreateJoinTableUsersProjects users projects
# Ejecutar migraciones pendientes
bin/rails db:migrate
# Revertir el último paso de migración
bin/rails db:rollback STEP=1
Creación de Tablas (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: {}
# Referencia de clave foránea
t.references :organization, null: false, foreign_key: true
t.timestamps # Marcas de tiempo: created_at & updated_at
end
end
end
Modificación de Columnas y Tablas
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
Migraciones Reversibles
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