【Rails基礎】データベースのカラムを追加・削除する方法

Railsのデータベースにカラムを追加・削除したい！

Railsアプリを作っていると

既存のデータベースにカラムを追加・削除したい時ありますよね。

例えば、usersテーブルに

• name
• email
• nickname

というカラムがあったけど、

「画像のカラム（image）も作ってみたいなー」

とか

「ニックネームのカラム（nickname）いらねーなー」

というシチュエーションですね。

そんな時に備えてマスターしておきたいのが、

Railsでテーブルのカラムを追加・削除する方法

です。

今日はこちらの方法を紹介しますよ。

※ 利用環境は以下の通りです。

Railsでカラムを追加する方法

まずカラム追加する方法から。

Step1. マイグレーションファイルを作成

データベースをいじる前に、マイグレーションファイルを生成しましょう。

マイグレーションファイルとは、データベースの作成・変更に必要なファイルです。

データベースの設計図、下書きと例えられることが多いです。

Railsではいきなりデータベースの中身を編集しません。

マイグレーションファイルを作り、変更の要件を書き込み、実行してデータベースの中身を書き換えます。

そのマイグレーションファイルを作るコマンドはズバリ、

です。

例えば、

とすれば add_image_to_users というマイグレーションファイルが誕生するのです。

マイグレーションファイルの名前はぶっちゃけなんでもいいんですが、名前に

• テーブル名
• カラム名

を含ませると、なおよし。

マイグレーションファイルを見返した時、「生誕の理由」を察しやすいでしょう。

ただ、ネーミングは自由で規則はありません。

Step2. マイグレーションファイルを編集する

マイグレーションファイルを編集します。

マイグレーションファイルの場所は、Railsアプリの階層でいうと

db > migrate

に入っていますね。

さきほど誕生したマイグレーションファイルは、肝心の部分は白紙。

つまり、自分で変更内容を書かなければなりません。

具体的にいうと、

というchangeメソッドの中身を書いていきます。

カラムを追加したい時は、changeメソッドに、

add_column :テーブル名, :カラム名, :データ型

を記載しましょう。

例えば、usersテーブルにimageカラム（string型）を追加したいときは、こんな感じですね。

Step3. マイグレーションファイルを実行

さて、あとはマイグレーションファイルを実行するだけ。

実行のコマンドは、

ですよ。

コマンドラインで発動しちゃってください。

カラムを削除したい時はどうする？？

以上、Railsのデータベースにカラムを追加する方法でした。

それでは、カラムを削除する方法はどうなんでしょうかね。

じつは、削除方法も簡単。

さっきのStep 2で「メソッド名を変えるだけ」です。

お察しの通り、add_columnではなくremove_columnにすればいいのです。

だから、先ほどの例で出したchangeメソッドはこうなります。

これでマイグレーションファイルを同じように

を実行すると、指定カラムを削除できますね。

複数のカラムを同時に追加・削除したい時はどうする？？

が、しかし時には、

1つのマイグレーションファイルで「複数のカラム」を追加・削除したい時がありますよね。

1カラムごとに1マイグレーションファイルを作っていたら日が暮れちゃいますからね。

そんな時は、シンプルに、

changeメソッド内に複数の命令文を書けばOK。

例えば、

としてやると、imageカラムだけなく、birthdayカラムまでusersテーブルに追加できちゃうわけです。

この方法は何もadd_columnだけでなく、remove_columnを混ぜても構いません。

カラムの追加・削除はRailsアプリで必要になる技なので、マスターしておきましょう。

それでは！

Lin

【参考記事】

Qiita

Ruby on Rails カラムの追加と削除 - Qiita

https://qiita.com/azusanakano/items/a2847e4e582b9a627e3a

# マイグレーションスクリプトの作成マイグレーションを使ってテーブルに変更を行う場合、以前のマイグレーションスクリプトを修正するのではなく、変更を加える為の別のマイグレーションスクリプトを作成し実行します。モデルを作成する時...

Qiita

rails カラムの複数追加 - Qiita

https://qiita.com/kapi0050/items/1dd4e79b673f9479fccb

$ rails generate migration add_カラム名_To_テーブル名 カラム名:データ型 カラム名:データ型（例）$ rails generate migration add_basic_info_to_use...

飯橋凛（いいはし りん）

おそらく、ブロガー。現在ホテル暮らしで全国フラフラしています。

ネット広告代理店に1年3ヶ月勤め上げ、独立をして丸4年が経ちました。今年でフリーランス 5年目。

質問・ご意見・相談があればLINEで受け付けていますのでお気軽にどうぞ 。