SQLに強くなろう!Ruby on Railsのfindメソッドの使い方【初心者向け】
RailsでSQL上で特定の条件で検索する際にfindというメソッドを使います。今回はそのfindを使ってデータベースの情報を取得する流れを説明していきます。
テックアカデミーマガジンは受講者数No.1のプログラミングスクール「テックアカデミー」が運営。初心者向けにプロが解説した記事を公開中。現役エンジニアの方はこちらをご覧ください。 ※ アンケートモニター提供元:GMOリサーチ株式会社 調査期間:2021年8月12日~8月16日 調査対象:2020年8月以降にプログラミングスクールを受講した18~80歳の男女1,000名 調査手法:インターネット調査
監修してくれたメンター
mentor-hakamata
C#, Ruby, Python, JavaScriptなど経験。
RubyのフレームワークRuby on Railsでのfindを使ったデータベースの扱い方について、テックアカデミーのメンター(現役エンジニア)が実際のコードを使用して初心者向けに解説します。
SQLで特定の条件で検索する際にfindというメソッドを使います。
今回はそのfindを使ってデータベースの情報を取得する流れを説明していきます。
目次
Rubyについてそもそもよく分からないという方は、Rubyとは何なのか解説した記事を読むとさらに理解が深まります。
今回はfindについて解説しよう。
田島メンター!!findは何をするんですか〜?
データベースから指定したデータを検索する機能だよ。実際にやってみようか。
はい!
findとは
Ruby on Railsはデータベースとやり取りを行う際ActiveRecordというORM(Object-relational mapping)を使います。
そのActiveRecordの中でデータを取得する際に使用するのがfindメソッドになります。
ORMは最終的にSQLを生成してデータベースとやり取りを行います。
例えばUserモデルに対してfindメソッドを行ってみると、
irb(main):001:0> User.find(1) User Load (0.7ms) SELECT "users".* FROM "users" WHERE "users"."id" = $1 LIMIT $2 [["id", 1], ["LIMIT", 1]]
このようなSQLが実行されていることを確認できます。
$1という部分にはfindメソッドの引数の1が設定されてSQLが実行されます。($2には[“LIMIT”, 1]の1が設定されます、1行だけ取得するという意味です)。
usersテーブルのidに対しての検索条件ということが分かります。
findでデータが見つからない場合
findメソッドでデータが取得できない場合はエラーになります。
実際に実行して確認してみましょう。
irb(main):005:0> User.find(0) User Load (0.6ms) SELECT "users".* FROM "users" WHERE "users"."id" = $1 LIMIT $2 [["id", 0], ["LIMIT", 1]] /usr/local/bundle/gems/activerecord-7.0.2.2/lib/active_record/core.rb:284:in `find': Couldn't find User with 'id'=0 (ActiveRecord::RecordNotFound)
検索条件に該当する(id=0に該当する)データがないといったエラーが出力されています。
このUser.find(1)というのはどこでやるんですか?
ターミナルで”rails console”(あるいはrails c)を実行してから、findを使うよ。終了するときはexitするのを忘れないようにしよう。
なるほど、了解です!
find_byとの違い
findメソッドに似たメソッドとしてfind_byメソッドがあります。
find_byメソッドでもfindメソッドと同じようなことができますが、検索条件とするカラムを指定する必要があります。
このようにidカラムを検索条件とする場合はfind_byメソッドの引数を以下のようにします。
irb(main):007:0> User.find_by(id: 1) User Load (0.7ms) SELECT "users".* FROM "users" WHERE "users"."id" = $1 LIMIT $2 [["id", 1], ["LIMIT", 1]]
idが検索条件になっていることが分かります。
カラムの指定ができるので、id以外のカラムを検索条件にすることも可能です。
irb(main):011:0> User.find_by(name: "tarou") User Load (0.5ms) SELECT "users".* FROM "users" WHERE "users"."name" = $1 LIMIT $2 [["name", "tarou"], ["LIMIT", 1]]
nameに対して検索条件を設定し、検索が実行されています。
また複数のカラムを検索条件とすることも可能です。
irb(main):012:0> User.find_by(id: 1, name: "tarou") User Load (0.7ms) SELECT "users".* FROM "users" WHERE "users"."id" = $1 AND "users"."name" = $2 LIMIT $3 [["id", 1], ["name", "tarou"], ["LIMIT", 1]]
idとnameに対して検索条件を設定し、検索が実行されています。
find_byでデータが見つからない場合
find_byメソッドでデータが取得できない場合はnilが戻り値となります。
実際に実行して確認してみましょう。
irb(main):008:0> User.find_by(id: 0) User Load (0.6ms) SELECT "users".* FROM "users" WHERE "users"."id" = $1 LIMIT $2 [["id", 0], ["LIMIT", 1]] => nil
findメソッドとは異なり、エラーとならず、nilが戻り値となっていることが分かります。
実際にfindを書いてみよう
引数に取得したいレコードのidを指定してレコードを取得します。
引数は複数指定することも可能です。
なお、例ではUserモデルを使用します。
1件のみ取得する
User.find(1)
id=1のusersのレコードを取得します。
irb(main):013:0> User.find(1) User Load (0.7ms) SELECT "users".* FROM "users" WHERE "users"."id" = $1 LIMIT $2 [["id", 1], ["LIMIT", 1]]
2件取得する
User.find(1, 2)
id=1とid=2のusersのレコードを取得します。
irb(main):014:0> User.find(1, 2) User Load (0.6ms) SELECT "users".* FROM "users" WHERE "users"."id" IN ($1, $2) [["id", 1], ["id", 2]]
以上、findメソッドについて解説しました。
このように検索については、色々な方法があるよ。
これがあると、データベースから特定のものを探すときに便利そうですね。
処理に応じて使い分けられるようにしっかり理解しておくようにしよう。
分かりました、ありがとうございます!
Ruby on Railsを学習中の方へ
これで解説は終了です、お疲れさまでした。
- つまずかず「効率的に」学びたい
- 副業や転職後の「現場で使える」知識やスキルを身につけたい
プログラミングを学習していて、このように思ったことはありませんか?
テックアカデミーのWebアプリケーションコースでは、第一線で活躍する「プロのエンジニア」が教えているので、効率的に実践的なスキルを完全オンラインでしっかり習得できます。
合格率10%の選考を通過した、選ばれたエンジニアの手厚いサポートを受けながら、Ruby on Railsを使ったWebアプリケーション開発を学べます。
まずは一度、無料体験で学習の悩みや今後のキャリアについて話してみて、「現役エンジニアから教わること」を実感してみてください。
時間がない方、深く知ってから体験してみたい方は、今スグ見られる説明動画から先に視聴することをおすすめします!