Kurzreferenz

Rails-Datenbankmigrationen Spickzettel

Ein Schnellreferenz-Leitfaden für Rails-Datenbankmigrationen: create_table, Spaltentypen, Fremdschlüssel, zusammengesetzte Indizes, umkehrbare Änderungen und Rake-Tasks.

· Veröffentlicht

Active Record-Migrationen ermöglichen es Ihnen, das Datenbankschema im Laufe der Zeit mithilfe einer reinen Ruby-DSL weiterzuentwickeln, ohne manuell SQL-DDL-Befehle schreiben zu müssen.

Migrations-CLI-Generatoren

# Migration für eine neue Tabelle generieren
bin/rails g migration CreateArticles title:string body:text published:boolean

# Migration zum Hinzufügen einer Spalte generieren
bin/rails g migration AddViewsToArticles views:integer

# Join-Tabelle generieren
bin/rails g migration CreateJoinTableUsersProjects users projects

# Ausstehende Migrationen ausführen
bin/rails db:migrate

# Letzten Migrationsschritt rückgängig machen
bin/rails db:rollback STEP=1

Tabellen erstellen (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: {}

      # Fremdschlüssel-Referenz
      t.references :organization, null: false, foreign_key: true

      t.timestamps # Zeitstempel: created_at & updated_at
    end
  end
end

Spalten & Tabellen modifizieren

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

Umkehrbare Migrationen (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

Referenzen

Verwandte Themen