はじめに

本記事はドットインストールActive Record入門 (全19回)で学習した時のメモ書きである。

#対象読者
ActiveRecordを勉強しようと思っている、Rubyの文法は基本的に知っている初心者

#本記事の目的
ActiveRecordの一機能である、「レコード抽出機能」を理解するための自分用のアウトプット記事

#実行環境

	バージョン	Extra
CentOS	6.9	VirtualBox経由でssh接続
VirtualBox	5.1.18
ActiveRecord	5.1.0
MySQL	5.7.18
Ruby	2.4.1	rbenvで管理
Bundler	1.14.6

#各種設定/実行ファイル

Gemfile

# frozen_string_literal: true
source "https://rubygems.org"

# gem "rails"
gem "activerecord"
gem "mysql2"
gem "sinatra"

database.yml

development:
  adapter: mysql2
  database: TestApp
  host: localhost
  username: root
  password: ××××××××
  encoding: utf8

main.rb

require 'active_record'
require 'pp'
require 'mysql2'

Time.zone_default = Time.find_zone! 'Tokyo'
ActiveRecord::Base.default_timezone = :local

ActiveRecord::Base.configurations = YAML.load_file('database.yml')
ActiveRecord::Base.establish_connection(ActiveRecord::Base.configurations['development'])

class User < ActiveRecord::Base
end

# insert

User.delete_all

User.create(name: "tanaka", age: 19)
User.create(name: "takahashi", age: 25)
User.create(name: "hayashi", age: 31)
User.create(name: "mizutani", age: 28)
User.create(name: "otsuka", age: 35)

#以下をいじる

実行コマンド

bundle exec ruby main.rb

#レコードの抽出
##selectメソッド
抽出するフィールドを指定したい場合はselectメソッドを用いる。

selectメソッドの例

#id, name, ageの値だけ、全てのレコード分表示
pp User.select("id, name, age").all

#id, ageの値だけ、最初の３件のレコード分だけ表示
pp User.select("id, age").first(3)

ppはpretty printというツールで見やすい形で出力してくれる。

##findメソッド

主キーによる検索結果を抽出したい場合はfindメソッドを用いる。

findメソッドの例

# 主キー(id)の値が3であるレコードのid, name, ageの値を抽出
pp User.select("id, name, age").find(3)

##find_byメソッド

その他のフィールドによる検索結果を抽出したい場合はfind_byメソッドを用いる。
メソッドの引数に検索対象のフィールドとその値をハッシュ形式で記載する。

find_byメソッドの例

# nameがtanakaであるレコードのid, name, ageの値を抽出
# 該当するレコードがなかったらエラーを返す。
pp User.select("id, name, age").find_by!(name: "tanaka")
pp User.select("id, name, age").find_by_name! "tanaka"

メソッドの最後に!をつけると、該当レコードがない時にエラーを吐き出す。つけなかった場合はnilが返る。

##whereメソッド
whereメソッドを使えば範囲指定など、より複雑な検索が可能。

whereメソッドの例

# ageの値が20から29の間にあるレコードのid, name, ageの値を抽出
pp User.select("id, name, age").where(age: 20..29)
pp User.select("id, name, age").where("age >= 20 and age < 30")#

# idが3でないレコードのid, name, ageの値を抽出
pp User.select("id, name, age").where.not(id: 3)

※注意点
条件を記述する際、変数を用いるとき、プレースホルダーを使って条件文字列に安全に値を埋め込むことが必要。

プレースホルダーを用いた例

min = 20
max = 30

#以下二つは同様の意味
#?多いと見にくいからシンボルを用いることもある
pp User.select("id, name, age").where("age >= ? and age < ?", min, max)
pp User.select("id, name, age").where("age >= :min and age < :max", {min: min, max: max})

部分一致の検索結果を抽出したい場合もプレースホルダーを用いる。

部分一致検索にプレースホルダーを用いた例

# 名前が"a"で終わるレコードのid, name, ageの値を抽出
pp User.select("id, name, age").where("name like ?", "%a")