Migracje Active Record pozwalają na bezpieczną ewolucję schematu bazy danych za pomocą czystego DSL w Ruby, bez konieczności ręcznego pisania poleceń SQL DDL.
Generatory CLI migracji
# Generowanie migracji nowej tabeli
bin/rails g migration CreateArticles title:string body:text published:boolean
# Generowanie migracji dodającej kolumnę
bin/rails g migration AddViewsToArticles views:integer
# Generowanie tabeli łączącej (join table)
bin/rails g migration CreateJoinTableUsersProjects users projects
# Wykonanie oczekujących migracji
bin/rails db:migrate
# Wycofanie ostatniego kroku migracji
bin/rails db:rollback STEP=1
Tworzenie tabel (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: {}
# Klucz obcy
t.references :organization, null: false, foreign_key: true
t.timestamps # Znaczniki czasu: created_at i updated_at
end
end
end
Modyfikowanie kolumn i tabel
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
Odwracalne migracje (Reversible)
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