プログラミング

Active Record 基本ガイド

最終更新： 07/04/2025
1 分の読み

Active Recordは、オブジェクト関係マッピング（ORM）パターンの一種であり、Ruby on Railsの中核的なコンポーネントとして非常に広く使用されています。データベースとオブジェクト指向プログラミングの橋渡しをするこの技術は、データベース操作を簡潔にし、開発者が複雑なSQLクエリを直接書く必要をなくします。この記事では、Active Recordの基本的な概念について、具体的な使用法とともに解説します。

1. Active Recordの基本的な概念

Active Recordは、データベースのテーブルをRubyオブジェクトとして表現し、テーブルの行をそのオブジェクトのインスタンスとして扱います。これにより、データベースの操作をオブジェクト指向の方法で行うことができ、SQLを意識せずにデータの読み書きが可能になります。

関連記事

2. クラスとテーブルの対応

Active Recordでは、クラスとテーブルは一対一の対応関係にあります。例えば、usersテーブルに対応するクラスはUserクラスとなります。Railsでは通常、テーブル名は複数形、クラス名は単数形を使用します。この規則により、クラスとテーブルの関連付けが簡単になります。

ruby
class User < ApplicationRecord
  # Userクラスはusersテーブルに対応
end

ApplicationRecordは、Railsのすべてのモデルクラスが継承する基本クラスです。このクラスには、Active Recordの機能が組み込まれています。

3. データの読み込み

データの読み込みは非常に簡単に行えます。Active Recordには、いくつかの便利なメソッドが用意されています。最も一般的なものはfind、where、allなどです。

  • find: 主キーで検索を行い、該当するレコードを返します。

ruby
user = User.find(1)  # idが1のユーザーを取得

  • where: 条件を指定して複数のレコードを検索します。

ruby
users = User.where(age: 25)  # 年齢が25歳のユーザーを取得

  • all: テーブル内のすべてのレコードを取得します。

ruby
users = User.all  # すべてのユーザーを取得

これらのメソッドを使うことで、SQLを直接書かずにデータを簡単に取得できます。

4. データの書き込み

データの書き込みもシンプルです。新しいレコードを作成するには、インスタンスを生成して属性を設定し、saveメソッドでデータベースに保存します。

ruby
user = User.new(name: "Taro", age: 30)
user.save  # 新しいユーザーをデータベースに保存

saveは、レコードが正常に保存された場合にtrueを返します。失敗した場合にはfalseを返します。また、createメソッドを使えば、インスタンスを作成して即座に保存することができます。

ruby
user = User.create(name: "Jiro", age: 28)  # 作成して保存

5. データの更新

既存のレコードの更新も簡単です。オブジェクトの属性を変更してからsaveを呼び出すことで、変更をデータベースに反映させます。

ruby
user = User.find(1)  # idが1のユーザーを取得
user.name = "Taro Updated"
user.save  # 更新されたユーザーを保存

また、updateメソッドを使うと、属性を直接渡して一度に更新できます。

ruby
user.update(name: "Jiro Updated", age: 32)

6. データの削除

レコードを削除するには、destroyメソッドを使用します。このメソッドは、オブジェクトをデータベースから削除します。

ruby
user = User.find(1)
user.destroy  # ユーザーを削除

deleteメソッドを使うと、オブジェクトを削除することはできますが、コールバックが呼ばれない点に注意が必要です。destroyを使用することが推奨されます。

7. トランザクション

Active Recordでは、複数のデータ操作を一つのトランザクションとしてまとめることができます。これにより、データベースの整合性を保ちながら、一貫した操作を実現できます。

ruby
ActiveRecord::Base.transaction do
  user1 = User.create(name: "User1", age: 20)
  user2 = User.create(name: "User2", age: 25)
  # 何らかの条件でエラーが発生した場合、ここまでの変更はロールバックされる
end

8. バリデーション

Active Recordは、データの整合性を保つためにバリデーション機能を提供しています。これにより、モデルがデータベースに保存される前に、条件を満たしているかを確認できます。

ruby
class User < ApplicationRecord
  validates :name, presence: true  # 名前が必須
  validates :age, numericality: { only_integer: true }  # 年齢は整数でなければならない
end

バリデーションに失敗した場合、saveはfalseを返します。エラーメッセージを確認することができます。

ruby
user = User.new(name: "", age: 25)
user.save  # 保存に失敗する
user.errors.full_messages  # エラーメッセージを取得

9. 関連の定義

Active Recordでは、モデル同士の関連を定義することができます。例えば、ユーザーが複数の投稿を持っている場合などです。これを行うために、has_manyやbelongs_toを使用します。

ruby
class User < ApplicationRecord
  has_many :posts  # ユーザーは複数の投稿を持つ
end

class Post < ApplicationRecord
  belongs_to :user  # 投稿は1人のユーザーに属する
end

このように定義することで、関連するデータを簡単に操作できるようになります。

ruby
user = User.find(1)
user.posts  # ユーザーのすべての投稿を取得

10. マイグレーション

Active Recordでは、データベースの構造を変更するためにマイグレーションを使用します。マイグレーションは、データベーススキーマの変更を管理し、バージョン管理を行うためのツールです。例えば、新しいカラムを追加する場合は、次のようにマイグレーションを作成します。

bash
rails generate migration AddAgeToUsers age:integer
rails db:migrate

これにより、usersテーブルにageカラムが追加されます。

まとめ

Active Recordは、Ruby on Railsでデータベース操作をシンプルかつ効率的に行うための強力なツールです。テーブルとクラスの対応、データの読み書き、関連付け、バリデーションなど、豊富な機能を備えており、Rails開発者にとっては必須の技術です。Active Recordを使いこなすことで、データベースとのやり取りをより直感的に、そして効果的に行うことができます。

最終更新： 07/04/2025
1 分の読み
Back to top button