ActiveRecordには、データベースからオブジェクトを取り出す
検索メソッドが多数用意されています。
検索メソッドはwhereやgroupといったコレクションを返したり、
ActiveRecord::Relationのインスタンスを返します。
またfindやfirstなどの１つのエンティティを検索するメソッドの場合、
そのモデルのインスタンスを返します。
単一のオブジェクトを取り出す
find
主キーで検索
# 主キーが1のユーザーを検索
User.find(1)
# SELECT * FROM users WHERE (users.id = 1) LIMIT 1
findメソッドで複数のオブジェクトを取得
# 主キーが1と10のユーザーを検索
User.find(1,10) # User.find([1,10])も可
# SELECT * FROM users WHERE (users.id IN (1,10))
findメソッドでマッチするレコードが見つからない場合、
ActiveRecord::RecordNotFound例外が発生します。
first
デフォルトでは主キー順の最初のレコードを取得
User.first
# SELECT * FROM users ORDER BY users.id ASC LIMIT 1
firstメソッドで返すレコードの最大数を指定して取得
User.first(3)
# SELECT * FROM users ORDER BY users.id ASC LIMIT 3
orderを使って順序を変更した場合、
firstメソッドはorderで指定された属性にしたがって最初のレコードを取得
User.order(:name).first
# SELECT * FROM users ORDER BY users.name ASC LIMIT 1
firstメソッドは、モデルにレコードが1つもない場合にnilを返します。
このとき例外は発生しません。
last
デフォルトでは主キーの順序にしたがって最後のレコードを取得
User.last
# SELECT * FROM users ORDER BY users.id DESC LIMIT 1
lastメソッドは、モデルにレコードが1つもない場合にnilを返します。
このとき例外は発生しません。
find_by
与えられた条件にマッチするレコードのうち、最初のレコードを取得
User.find_by(name: "hoge")
# SELECT * FROM users WHERE (users.name = "hoge") LIMIT 1
find_byメソッドは、モデルにレコードが1つもない場合にnilを返します。
このとき例外は発生しません。
条件
where
返されるレコードを制限するための条件を指定します。
SQL文でいうWHEREの部分に相当します。
User.where(name: "hoge")
# SELECT * FROM users WHERE (users.name = "hoge")
・NOT条件
SQLのNOTクエリはwhere.notで表せます。
User.where.not(name: "hoge")
# SELECT * FROM users WHERE (users.name != "hoge")
・OR条件
1つ目のリレーションでorメソッドを呼び出し、そのメソッドの引数に
2つ目のリレーションを渡します。
User.where(name: "hoge").or(User.where(name: "foo"))
# SELECT * FROM users WHERE (users.name = "hoge") OR (users.name = "foo")
並び順
データベースから取り出すレコードを特定の順序で並び替え
# ひとかたまりのレコードを取り出し、created_atの昇順で並び替え
User.order(:created_at)
# SELECT * FROM users ORDER BY users.created_at ASC
複数のフィールドを指定して並び替え
User.order(name: :asc, created_at: :desc)
# SELECT * FROM users ORDER BY users.name ASC, users.created_at DESC
取り出すレコード数の上限を指定
limit
主キー順の最初から数えて5件のレコードを取得
User.limit(5)
# SELECT * FROM users LIMIT 5
テーブルの結合
joins
デフォルトは内部結合(INNER JOIN)
内部結合は「結合条件に一致するレコードのみを取得」
この場合だとpostsテーブルのuser_idと、usersテーブルのidを指定
# モデル.joins(:関連名)
User.joins(:posts)
# SELECT users.* FROM users INNER JOIN posts ON (posts.user_id = users.id)
left_joins
左外部結合(LEFT OUTER JOIN)
「結合条件に一致するレコード」と「左側のテーブルにしかないレコード」を取得
User.left_joins(:posts)
# SELECT users.* FROM users LEFT OUTER JOIN posts ON (posts.user_id = users.id)
関連付けを一括読み込みする
includes
一括読み込み(eager_loading)とは、Model.findによって返されるオブジェクトに関連付けられたレコードを読み込むためのメカニズムであり、できるだけクエリの回数を減らすようにします。
・N+1クエリ問題
以下のコードは、ユーザーを10人検索して郵便番号を表示します。
usersテーブルとaddressesテーブルの関係は1対1とします。
users = User.limit(10)
users.each do |user|
puts user.address.postcode
end
このコードには問題があります。実行されたクエリの数が無駄に多いことです。
最初にユーザーを10人検索するのにクエリを1回発行し、次にそこから住所を取り出すのに
クエリを10回発行するので、合計11回のクエリが発行されます。
・N+1クエリ問題を解決する
ActiveRecordは、読み込まれるすべての関連付けを事前に指定することができます。
これはincludesを指定することで実現できます。
includesを指定すると、ActiveRecordは指定されたすべての関連付けが最小限のクエリ回数で
読み込まれるようにしてくれます。
上の例でいうと、User.limit(10)を書き直して、住所が一括で読み込まれるようにします。
users = User.includes(:address).limit(10)
users.each do |user|
puts user.address.postcode
end
最初の例では11回もクエリが発行されましたが、今回の例では2回にまで減りました。
SELECT * FROM users LIMIT 10
SELECT addresses.* FROM addresses
WHERE (addresses.user_id IN (1,2,3,4,5,6,7,8,9,10))