Railsでデータ操作の基本（CRUD）をマスターしよう

はじめに

リンクをコピーしました

概要

リンクをコピーしました

この記事では、Ruby on Railsフレームワークを使用して、データベース操作の基本であるCRUD（Create, Read, Update, Delete）の各プロセスを実行する方法を学びます。Railsの強力なORM（オブジェクトリレーショナルマッピング）システムであるActiveRecordを活用し、データの作成、読み出し、更新、削除を行うための具体的な手法を紹介します。

各セクションでは、create、new/save、all、find、find_by、where、update、destroyなどのメソッドを用いた効果的なデータ操作の例を詳しく解説し、Railsにおけるデータベース管理の基本を習得することを目指します。

目標

リンクをコピーしました

• ActiveRecordを使用してRailsでデータベースのCRUD操作を理解し、実践する。
• データベースでのデータの作成、読み出し、更新、削除のためのメソッドを学ぶ。
• Railsアプリケーションでのデータ管理の基本を習得し、より効率的なデータ操作を実現する。

必要な前提条件・事前準備

リンクをコピーしました

Railsでのデータ操作の基本を学ぶためには、いくつかの事前準備が必要です。まず、前章「Railsでのデータベース設計と操作を学ぼう」を完了していることが前提です。この知識は、本章で学ぶ内容を理解する上での基盤となります。また、本章でのデータ操作にはRailsコンソールの使用が伴いますので、その起動方法についても事前に確認しておきましょう。

• 前章「Railsでのデータベース設計と操作を学ぼう」を完了していること
• Railsコンソールの起動方法についての基本的な理解

以下の手順に従って、Railsコンソールの起動方法を確認しましょう。これにより、CRUD操作をコンソール上で実践的に学ぶ準備が整います。

Railsコンソールの起動方法

リンクをコピーしました

データ操作は、コンソール上で行います。Railsでは、consoleコマンドでコンソールを起動させて、Railsアプリケーションとコマンドラインでやり取りすることができます。

Webにアクセスすることなく、サーバーのデータを変更するときやメソッドを試すときに便利です。内部ではirbが使われているので、同じように操作を行えます。

1
2
rails console
# rails c でも可能

他にもオプションの-sandboxを付けることで、終了時にコンソールで変更したデータを元に戻すことができます。

1
2
rails console -sandbox
# rails c -s でも可能

上記のコマンドを実行すると、下の画像のようにin sandboxが表示されます。

コンソールを終了するには、exitかquitを実行します。

1
2
3
exit
#もしくは、以下を実行する
quit

以下のコマンドを実行して、コンソールを起動してください。

1
cd ~/environment/employee_management

1
rails c

上記のコマンドを実行すると、以下のように表示されます。

ActiveRecordによるCRUD操作の基礎

リンクをコピーしました

ActiveRecordは、CRUDの機能を提供します。

CRUDとは、Create（作成）・Read（読み込み）・Update（更新）・Delete（削除）の頭文字を繋げた用語で、データ操作の基本となる４つの処理のことでしたね。

SQLでは、CRUDに対応するデータ操作言語のキーワードとしてINSERT・SELECT・UPDATE・DELETEが用意されており、これらを利用してデータ操作を学習しました。

Railsでは、ActiveRecordを通じてCRUD（Create、Read、Update、Delete）に対応する多くの便利なメソッドが提供されています。これにより、開発者はデータベースとのやり取りを効率的に行うことが可能です。

オブジェクトによるデータ操作

リンクをコピーしました

前章で少し触れましたが、ActiveRecordでは「モデルのクラス」と「データベースのテーブル」が１対１で紐付けられます。

例えば、以下のようにモデルのUserクラスの場合は、データベースのusersテーブルに紐付きます。

1
2
class User < ApplicationRecord
end

ActiveRecordでは、「モデル」と「テーブル」の間だけでなく、「モデルのインスタンス」と「テーブルのレコード」、モデルのインスタンスの「属性（またはプロパティ）」と「テーブルのカラム」も1対1で対応付けられます。

モデルクラスのインスタンスは、テーブルのレコード１件に対応するオブジェクトになり、オブジェクトのプロパティは、テーブルのカラムに対応します。

Rubyのクラスとインスタンスの章で学習しましたが、インスタンスを生成するには、クラスに対して「newメソッド」を呼び出します。

1
クラス名.new

モデルクラスの場合でも、同じように「newメソッド」を呼び出してインスタンスを生成します。しかし、通常のクラスとは違って生成されたインスタンスは、「テーブルのレコード１件」に対応するオブジェクトになります。

1
2
モデルのクラス名.new 
#レコード１件に対応するオブジェクトになる

モデルクラスのインスタンス（オブジェクト）に対して、ActiveRecordが提供するメソッドを利用することで、テーブルにレコードを挿入したり、更新や削除などが行えます。まさにオブジェクトを操作するように、データ操作ができます。

例えば、Userモデルクラスのインスタンスに対して、ActiveRecordが提供するsaveメソッドを呼び出せば、テーブルにデータを挿入することができます。

1
2
3
4
5
# Userモデルのインスタンスをuserに代入する
user = User.new(name: "山田花子", age: 34)

# saveメソッドでインスタンスをデータベースに保存する
user.save

メソッドの箇所で詳しく説明しますが、モデルのクラスに対してnewメソッドを呼び出した時点では、「テーブルのレコード１件」に対応するオブジェクトが生成されただけです。実際にデータベースに保存するのは、saveメソッドが行います。

SQLではINSERT構文を使用して、テーブルに新しいレコードを挿入しましたが、RailsではActiveRecordのお陰で、オブジェクトを操作するようにデータ操作が可能になります。

1
INSERT INTO users(name, age) VALUES('山田花子', 34);

1
2
user = User.new(name: "山田花子", age: 34)
user.save

ちなみにモデルのインスタンスに対してsaveメソッドを呼び出すと、裏側では以下のようなSQL文が発行されます。実際にはINSERT構文を使用して、テーブルにレコードを挿入していることがわかりますね。

1
2
3
4
user = User.new(name: "山田花子", age: 34)

user.save
# INSERT INTO `users` (`name`, `age`, `created_at`, `updated_at`) VALUES ('山田花子', 34, '2023-03-24 07:47', '2023-03-24 07:47'

newメソッドを呼び出した時点で特に指定されてないcreated_atやupdated_atの値は、発行されるSQL文により、「レコード作成時に現在の日時を自動的に設定する」ということを確認できます。

ActiveRecordの主要なメソッドとそれぞれのCRUD操作の関係は、次の表にまとめられています。

これらのCRUDに対応するメソッドを１つずつ詳しく学んでいきましょう。

補足説明

メソッドの引数にハッシュを指定する場合は、{}を省略することができます。newメソッドの引数は、実は{ キー: 値 }のハッシュを指定しています。キーがカラム名、値がカラムの値になります。

多くの場合、メソッドの引数のハッシュは{}を省略して記述します。

データの作成（Create）

リンクをコピーしました

Createは、「テーブルにレコードを挿入する」というデータ操作の基本処理を指します。

Railsの場合は、ActiveRecordが提供するsaveメソッド、createメソッドを利用することで、テーブルにレコードを挿入することができます。

createメソッドの使い方

リンクをコピーしました

createメソッドは、モデルのインスタンス生成と同時にデータベースに保存するクラスメソッドです。

Userモデルにnameとageというプロパティがある場合、Userモデルのクラスに対してcreateメソッドを呼び出すと、新しいレコードが１件作成され、データベースに保存されます。

1
モデルのクラス名.create(カラム名1: 値1, カラム名2: 値2)

1
User.create(name: "山田花子", age: 34)

以下をコンソールで実行し、nameカラムの値が"開発"のレコードをdepartmentsテーブルに挿入しましょう。

1
Department.create(name: "開発")

上記を実行すると、以下のように裏側でSQL文が発行されます。SQLの章で学習したようにINSERT構文で、テーブルに新しいレコードを挿入していることがわかりますね。

created_atやupdated_atには、現在の日時が自動的に設定されます。

phpMyAdminで確認すると、以下のようにdepartmentsテーブルにnameカラムの値が開発のレコードが１件挿入されています。また、idも自動的に値が入っていますね。

newメソッドとsaveメソッドの組み合わせ

リンクをコピーしました

saveメソッドは、モデルのインスタンスをデータベースに保存します。

createメソッドとは違い、saveメソッドはインスタンスを生成しません。そのため、インスタンス生成を行うnewメソッドとセットで利用します。

1
2
3
4
5
 # Userモデルのインスタンスを生成して、userに代入する
user = User.new(name: "山田花子", age: 34)

# saveメソッドでインスタンスをデータベースに保存する
user.save

モデルのクラスに対してnewメソッドを呼び出した時点では、「テーブルのレコード１件」に対応するオブジェクトが生成されただけです。実際にデータベースに保存するのは、saveメソッドが行います。

レコードに挿入する値は、最初のコードのようにnewメソッドの引数にハッシュで一度に指定することもできますし、あとのコードのように指定することもできます。

1
2
user = User.new(name: "山田花子", age: 34)
user.save

1
2
3
4
5
user = User.new

user.name = "山田花子"
user.age = 34
user.save

nameカラムの値が"営業"のレコードをdepartmentsテーブルに挿入してみます。

まずは、newメソッドを利用して、Departmentモデルのインスタンスを生成します。以下のコードをコンソールに記述し、実行しましょう。

1
department = Department.new(name: "営業")

上記を実行すると、以下のようにDepartmentモデルのインスタンスが生成されます。この時点では、newメソッドの引数で指定したname属性のみ値が設定されており、idやcreated_atとupdated_atの属性値は、いずれもnilで値が何も入っていない状態です。

続いて、生成したDepartmentモデルのインスタンスをsaveメソッドでデータベースに保存します。以下のコードをコンソールに記述し、実行しましょう。

1
department.save

上記を実行すると、以下のように裏側でSQL文が発行されます。INSERT構文で、テーブルに新しいレコードを挿入していることがわかりますね。

created_atやupdated_atには、現在の日時が自動的に設定されます。

phpMyAdminで確認すると、以下のようにdepartmentsテーブルにnameカラムの値が営業のレコードが１件挿入されています。また、idも自動的に値が入っていますね。

そして、Departmentモデルのインスタンスが入るdepartmentをコンソールで実行すると、以下のようにnewメソッドを呼び出した時点では、nilだった属性値に値が設定されていることがわかります。

idには2という値が設定され、created_atやupdated_atには、saveメソッドを実行した際の日時、つまりレコードを作成した現在の日時が設定されます。

複数レコードの一括挿入

リンクをコピーしました

データベースに複数のレコードを一度に挿入する方法はいくつか存在しますが、ここでは配列とハッシュを組み合わせて使用するcreateメソッドによる一括挿入を学習しましょう。

createメソッドでは、１件のレコードをデータベースに挿入することができましたね。

1
モデルのクラス名.create(カラム名1: 値1, カラム名2: 値2)

複数のレコードをデータベースに挿入させるには、配列の要素にハッシュを指定します。

1
2
3
4
5
モデルのクラス名.create([
  { カラム名1: 値1 }, # 1件目のレコード
  { カラム名2: 値2 }, # 2件目のレコード
  { カラム名3: 値3 }  # 3件目のレコード
])

employeesテーブルに挿入するデータは、以下の通りです。

employeesテーブルに複数レコードを挿入するために、以下のコードをコンソールに記述し、実行しましょう。

1
2
3
4
5
6
7
8
Employee.create([
  { name: '田中太郎', birthday: '1980-10-22', department_id: 1 },
  { name: '山田花子', birthday: '1983-08-20', department_id: 1 },
  { name: '高橋一朗', birthday: '1986-06-16', department_id: 2 },
  { name: '伊藤晴子', birthday: '1987-10-01', department_id: 1 },
  { name: '鈴木二郎', birthday: '1990-01-17', department_id: 2 },
  { name: '山口冬子', birthday: '1993-05-12', department_id: 2 }
])

上記を実行すると、以下のように裏側でSQL文が発行されます。INSERT構文で、テーブルに新しいレコードを６件挿入していることがわかりますね。

phpMyAdminでemployeesテーブルを表示して、createメソッドで指定した6件のレコードがテーブルに挿入されていることを確認しましょう。

補足説明

createメソッドの引数には、変数を利用して指定することもできます。

データの読み込み（Read）

リンクをコピーしました

Readは、「テーブルのレコードを抽出する」というデータ操作の基本処理を指します。

Railsの場合は、ActiveRecordが提供するallメソッド、findメソッドなどを利用することで、テーブルのレコードを抽出することができます。

allメソッド（全レコードの取得）

リンクをコピーしました

モデルのクラスに対してallメソッドを呼び出すと、モデルに対応するテーブルのレコードをすべて取得します。

1
モデルのクラス名.all

例えば、usersテーブルのレコードを全て取得する場合はUser.allと記述します。

1
User.all

employeesテーブルの全てのレコードを取得してみます。

以下のコードをコンソールに記述し、実行しましょう。

1
Employee.all

上記を実行すると、以下のように裏側でSQL文が発行されます。SQLの章で学習したようにSELECT構文で、テーブルのすべてのレコードを抽出していることがわかりますね。

戻り値には、employeesテーブルの全てのレコードが設定されています。

findメソッド（特定レコードの検索）

リンクをコピーしました

findメソッドは、引数の主キーに対応するレコードを取得するクラスメソッドです。

findメソッドの引数には１つの主キーだけではなく、配列で複数の主キーの値を指定して、レコードを取得することもできます。

1
モデルのクラス名.find(主キー値)

1
モデルのクラス名.find([主キー値1, 主キー値2])

テーブルの主キーは、idというカラム名がデフォルトで使われます。

例えば、以下のようにUser.find(1)と指定する場合、Userモデルに対応するusersテーブルの主キー、つまりidの値が1のレコードを取得します。

1
User.find(1)

以下のように指定すると、idの値が1と2のレコードを取得します。

1
User.find([1,2])

employeesテーブルのidの値が4のレコードを取得してみます。

以下のコードをコンソールに記述し、実行しましょう。

1
Employee.find(4)

上記を実行すると、以下のように裏側でSQL文が発行されます。SELECT構文で、employeesテーブルのidの値が4のレコードを抽出していることがわかりますね。

戻り値は、取得したデータの値がセットされているEmployeeモデルのインスタンスです。

find_byメソッド（条件付き単一レコードの検索）

リンクをコピーしました

find_byメソッドは、引数の条件に当てはまる最初の１件のレコードを取得するクラスメソッドです。

引数の条件は、ハッシュで指定します。

1
モデルのクラス名.find_by(条件)

1
User.find_by(name: '田中太郎')

employeesテーブルのnameの値が'鈴木二郎'のレコードを取得してみます。

以下のコードをコンソールに記述し、実行しましょう。

1
Employee.find_by(name: '鈴木二郎')

上記を実行すると、以下のように裏側でSQL文が発行されます。SELECT構文で、employeesテーブルのnameの値が'鈴木二郎'のレコードを抽出していることがわかりますね。

戻り値は、取得したデータの値がセットされているEmployeeモデルのインスタンスです。

whereメソッド（条件検索）

リンクをコピーしました

whereメソッドは、引数の条件に当てはまるレコードを全て取得するクラスメソッドです。

1
モデルのクラス名.where(条件)

find_byメソッドの場合は、引数の条件に当てはまる最初のレコードを1件だけ取得しますが、whereメソッドは、条件に当てはまる全てのレコードを取得します。

例えばUser.where(age: 20)とUser.find_by(age: 20)のように、引数に同じ条件を指定しても、取得するレコード数は違います。

1
User.where(age: 20)

1
User.find_by(age: 20)

以下のようにUser.where(age: 20)は、ageが20のレコードを全て取得します。

employeesテーブルのdepartment_idの値が2のレコードをすべて取得してみます。

以下のコードをコンソールに記述し、実行しましょう。

1
Employee.where(department_id: 2)

上記を実行すると、以下のように裏側でSQL文が発行されます。SELECT構文で、employeesテーブルのdepartment_idの値が2のレコードを抽出していることがわかりますね。

戻り値には、条件に当てはまるemployeesテーブルの全てのレコードが設定されています。

データの更新（Update）

リンクをコピーしました

Updateは、「テーブルのレコードを更新する」というデータ操作の基本処理を指します。

Railsの場合は、ActiveRecordが提供するupdateメソッドなどを利用することで、テーブルのレコードを更新することができます。

saveメソッド（変更内容の保存）

リンクをコピーしました

更新対象のオブジェクトを取得すると、オブジェクトのプロパティを変更し、その結果をデータベースに保存できるようになります。

例えば、以下のようにfind_byメソッドで更新対象のオブジェクトを取得し、nameプロパティ値を'田中太郎'から'田中航太郎'に変更します。変更後、saveメソッドを呼び出して、データベースに保存します。

1
2
3
user = User.find_by(name: '田中太郎') #更新対象のオブジェクトを取得
user.name = '田中航太郎' #プロパティを変更
user.save #データベースに保存する

updateメソッド（レコードの更新）

リンクをコピーしました

updateメソッドを利用する場合も、あらかじめfindメソッドやfind_byメソッドなどで、オブジェクトを取得してから更新処理を行います。

updateメソッドの引数にプロパティ名と設定したい値をハッシュで対応付けます。

1
更新対象のオブジェクト.update(プロパティ名: 値)

先ほどのsaveメソッドと同様に'田中太郎'を'田中航太郎'に更新する場合は、更新対象のオブジェクトを取得後、以下のようにupdateメソッドの引数を指定します。

updateメソッドを呼び出すと、更新対象のオブジェクトのプロパティを引数の値に更新し、その結果をデータベースに保存します。

1
2
user = User.find_by(name: '田中太郎')
user.update(name: '田中航太郎')

employeesテーブルにある山口冬子さんの生年月日、birthdayの値を1993-05-12から1993-12-12に更新してみます。

以下のコードをコンソールに記述し、実行しましょう。

1
2
employee = Employee.find_by(name: '山口冬子')
employee.update(birthday: '1993-12-12')

上記を実行すると、以下のように裏側でSQL文が発行されます。SQLの章で学習したように、既存のレコードのカラムを新しい値に更新するには、UPDATE構文が使用されます。

SET句には変更するカラム名と新しい値、WHERE句にはどのレコードを更新するかを識別する条件が指定されており、idが6のレコードのbirthdayを'1993-12-12'に更新していることがわかりますね。

また、レコードの更新時に現在の日時を設定するupdated_atの値も自動的に更新されます。データが更新されると、戻り値としてtrueを返します。

オブジェクトのプロパティ値が更新されていることを確認してみましょう。更新対象のオブジェクトを保持するemployeeをコンソールに記述し、実行しましょう。

1
employee

上記を実行すると、以下のように更新後のbirthdayのプロパティ値は、更新前と比べてupdateメソッドに指定した値に変更されていることがわかりますね。

phpMyAdminを再読み込みして、employeesテーブル内の山口冬子さんのbirthdayが1993-05-12から1993-12-12に更新されていることを確認しましょう。

また、updated_atの値も更新した日時に変更されたかを確かめてみてください。

データの削除（Delete）

リンクをコピーしました

Deleteは、「テーブルのレコードを削除する」というデータ操作の基本処理を指します。

Railsの場合は、ActiveRecordが提供するdestroyメソッド、destroy_allメソッドなどを利用することで、テーブルのレコードを削除することができます。

destroyメソッド（レコードの削除）

リンクをコピーしました

destroyメソッドを利用する場合、あらかじめfindメソッドやfind_byメソッドなどで、オブジェクトを取得してから削除処理を行います。

削除対象のオブジェクトに対して、destroyメソッドを呼び出します。

1
削除対象のオブジェクト.destroy

例えば、usersテーブルのnameカラムの値が'田中太郎'のレコードを削除するには、以下のように、まずオブジェクトを取得します。そして、取得したオブジェクトに対してdestroyメソッドを呼び出し、データベースからレコードを削除します。

1
2
user = User.find_by(name: '田中太郎')　#削除対象のオブジェクトを取得する
user.destroy #レコードを削除する

employeesテーブルにあるnameカラムの値が'山口冬子'のレコードを削除してみます。

以下のコードをコンソールに記述し、実行しましょう。

1
2
employee = Employee.find_by(name: '山口冬子')
employee. destroy

上記を実行すると、以下のように裏側でSQL文が発行されます。SQLの章で学習したように、テーブル内の既存のレコードを削除するには、DELETE構文が使用されます。

phpMyAdminを再読み込みして、employeesテーブルにあるnameの値が'山口冬子'のレコードが削除されていることを確かめてみましょう。

destroy_allメソッド（一括削除）

リンクをコピーしました

モデルのクラスに対してdestroy_allメソッドを呼び出すと、モデルに対応するテーブルのレコードをすべて削除します。

1
モデルのクラス名.destroy_all

usersテーブルのレコードを全て削除する場合は、User.destroy_allと記述します。

1
User.destroy_all

以下のコードを上から順番にコンソールで実行し、employeesテーブルのレコードから削除するようにしましょう。

1
Employee.destroy_all

1
Department.destroy_all

phpMyAdminを再読み込みして、departmentsテーブルとemployeesテーブル内のレコードが全て削除されたかを確認しましょう。

この章のまとめ

リンクをコピーしました

この章では、Railsでのデータ操作の基礎、特にCRUD（Create、Read、Update、Delete）操作に関する学習を行いました。ActiveRecordを活用した効率的かつ直感的なデータベース操作方法を理解し、実践する技術を習得しました。これにより、Railsアプリケーション開発のための重要な基礎が築かれました。

次の章に進む前に、以下のコマンドを実行して環境をリセットしておきましょう。この章をもう一度学習したい方は、以下のコマンドを実行した後、「ActiveRecordによるCRUD操作の基礎」から取り組んでみてください。

1
cd ~/employee_management

1
rails db:migrate:reset