こんにちは！社会人１年目の初心者エンジニアです。
最近、データベースのスキーマを変更するためにマイグレーションを利用することが多くなりました。
この記事では、テーブルに複数のカラムを追加する方法と、マイグレーションを実行する際の注意点について説明します。

1. change_table を使って複数カラムを追加する

新しいカラムを追加する際、change_tableメソッドを使うと、複数のカラムを一度にまとめて追加できます。以下は、employeesテーブルにphone_numberとdepartmentを追加するマイグレーションの例です。

class AddColumnsToEmployees < ActiveRecord::Migration[6.0]
  def change
    change_table :employees do |t|
      t.string :phone_number, comment: '電話番号'
      t.string :department, comment: '部署名'
    end
  end
end

change_tableの利点

上記の例のように、change_tableを使うことで、複数のカラムを一度に追加できる
複数のカラムをまとめて追加することで、マイグレーションファイルがすっきりする

コメントを追加するメリット

commentオプションを追加することで、以下のメリットがあります
- データベーススキーマを視覚的に理解しやすくなる
- データベースを見直す際に、コメントがあるとカラムの役割が明確になり、修正や新規機能の追加がスムーズに行える

コメント追加した際の例が以下になります。

t.string :phone_number, comment: '電話番号'
t.string :department, comment: '部署名'

2. テーブルのカラムを確認する

テーブルのカラムを確認したい場合、以下のコマンドを使用します。

ActiveRecord::Base.connection.columns(:確認したいテーブル名).map(&:name)

このコマンドを実行することで、テーブルに存在するカラム名のリストを確認できます。

3. マイグレーションの取り消し

もし最後に適用したマイグレーションを取り消したい場合、次のコマンドを使用します。

rails db:rollback

このコマンドを実行することで、最後に適用したマイグレーションが取り消されます。

4. マイグレーションファイルの修正に関する注意

一度マイグレーションを実行した後に、マイグレーションファイルを修正して再度rails db:migrateを実行することはできません。一度実行されると、そのマイグレーションはデータベースに適用済みとして記録されるため、修正したファイルは再実行されません。

修正が必要な場合の対応方法

もしマイグレーションファイルを修正する必要が生じた場合、以下の手順を行なってください

1.　修正したいマイグレーションを適用した後であれば、まずrails db:rollbackコマンドを使用して最後のマイグレーションを取り消します

rails db:rollback

2.　マイグレーションファイルを修正
ロールバックした後、必要な変更をマイグレーションファイルに追加した後、再度マイグレーションを実行する。

rails db:migrate

まとめ

Railsのマイグレーションを利用することで、データベースのスキーマを簡単に管理できます。change_tableを使って複数のカラムを一度に追加することができ、効率的に作業を進めることができます。カラムにコメントを追加することで、可読性やメンテナンス性が向上するため、ぜひ活用してみてください。この記事を参考にして、マイグレーションを活用してみてください。