プログラミング

Active Recordの基本解説

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

Active Recordは、オブジェクト指向プログラミング（OOP）において広く利用されるパターンで、特にデータベース操作を簡潔にするために使用されます。Ruby on Railsなどのフレームワークでよく利用されており、データベースのレコードをオブジェクトとして取り扱うことができます。この記事では、Active Recordの基本的な概念、使い方、モデルの作成方法などについて詳しく解説します。

1. Active Recordとは何か？

Active Recordは、データベースのテーブルに対応する「モデル」を使って、データをオブジェクトとして操作するパターンです。これにより、SQL文を直接書くことなく、Rubyのコードでデータベースの操作を行えるようになります。基本的には、テーブルの各行がオブジェクトになり、各カラムがそのオブジェクトの属性になります。

関連記事

例えば、usersというテーブルがあった場合、Active Recordではそのテーブルに対応するUserクラスを定義し、レコードの操作をそのクラスのインスタンスメソッドを使って行います。

2. Active Recordの基本的な機能

Active Recordは以下の基本的な機能を提供します。

  • CRUD操作: Create（作成）、Read（読み取り）、Update（更新）、Delete（削除）をオブジェクト指向の方法で簡単に行えるようにします。

  • バリデーション: データの整合性を保つために、属性に対するバリデーションを行うことができます。

  • アソシエーション: 他のモデルとの関係（例えば1対多、多対多など）を簡単に定義できます。

  • クエリビルダー: SQLを直接書かなくても、Active Recordが提供するメソッドを使って効率的にクエリを作成できます。

3. Active Recordの基本的な構文

Active Recordのクラスは、通常、データベースのテーブルに対応します。以下のコードは、usersテーブルに対応するUserクラスを定義した例です。

ruby
class User < ApplicationRecord
  # バリデーション
  validates :name, presence: true
  validates :email, presence: true, uniqueness: true
end

このクラスは、usersテーブルに対するCRUD操作を簡単に行うことができるメソッドを提供します。例えば、以下のようにレコードの操作が可能です。

ruby
# ユーザーの作成
user = User.create(name: "Taro", email: "[email protected]")

# ユーザーの検索
user = User.find(1)

# ユーザーの更新
user.update(name: "Jiro")

# ユーザーの削除
user.destroy

4. モデルの作成とマイグレーション

Active Recordを使用するためには、まずモデルを作成し、それに対応するデータベースのテーブルを準備する必要があります。これには「マイグレーション」と呼ばれる仕組みを使います。

例えば、Userモデルを作成するためには、次のようにコマンドを実行します。

bash
rails generate model User name:string email:string

これにより、次のようなマイグレーションファイルが作成されます。

ruby
class CreateUsers < ActiveRecord::Migration[6.0]
  def change
    create_table :users do |t|
      t.string :name
      t.string :email

      t.timestamps
    end
  end
end

マイグレーションを実行すると、usersテーブルがデータベースに作成されます。

bash
rails db:migrate

5. Active Recordのアソシエーション

Active Recordは、複数のテーブルを関連付けて操作するためのアソシエーションをサポートしています。例えば、「ユーザーは複数の投稿を持つ」という関係を定義する場合、以下のように書きます。

1対多の関係（UserとPost）

Userモデルは、複数のPostを持つ関係を定義します。

ruby
class User < ApplicationRecord
  has_many :posts
end

Postモデルは、1人のUserに属する関係を定義します。

ruby
class Post < ApplicationRecord
  belongs_to :user
end

これにより、ユーザーとその投稿を簡単に操作できるようになります。

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

# 投稿を作成
post = user.posts.create(title: "My Post", content: "Content of the post")

多対多の関係（StudentとCourse）

多対多の関係では、中間テーブルを使って関連付けを行います。例えば、StudentとCourseの多対多の関係を定義する場合、次のように書きます。

ruby
class Student < ApplicationRecord
  has_and_belongs_to_many :courses
end

class Course < ApplicationRecord
  has_and_belongs_to_many :students
end

ここでは、students_coursesという中間テーブルが必要です。このテーブルは、student_idとcourse_idを持ち、学生とコースの関係を管理します。

6. バリデーションとコールバック

Active Recordは、データの整合性を確保するためにバリデーションをサポートしています。バリデーションを使うと、レコードが保存される前に条件をチェックすることができます。

ruby
class User < ApplicationRecord
  validates :name, presence: true
  validates :email, presence: true, uniqueness: true
end

また、コールバックを使用して、特定の操作（保存、更新、削除など）の前後に処理を追加することもできます。

ruby
class User < ApplicationRecord
  before_save :normalize_name

  private

  def normalize_name
    self.name = name.capitalize
  end
end

7. Active Recordのクエリビルダー

Active Recordは、SQL文を直接書かなくても、メソッドを使って簡単にクエリを作成できます。例えば、usersテーブルから特定のユーザーを検索するには、以下のように記述します。

ruby
# 名前が"taro"のユーザーを検索
user = User.find_by(name: "taro")

# 年齢が30歳以上のユーザーを検索
users = User.where("age >= ?", 30)

# 最新のユーザー10人を取得
users = User.order(created_at: :desc).limit(10)

これにより、SQL文を自分で書かなくても、Active Recordが自動的に効率的なクエリを生成してくれます。

まとめ

Active Recordは、Ruby on Railsなどで使われる非常に強力で便利なパターンで、データベース操作をオブジェクト指向の形で簡潔に行えるようにします。CRUD操作、アソシエーション、バリデーション、クエリビルダーなど、さまざまな機能を提供しており、データベース操作を効率的に行うための非常に重要なツールです。

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