модуль ActiveRecord::Calculations

# File activerecord/lib/active_record/relation/calculations.rb, line 55
def average(column_name, options = {})
  # TODO: Remove options argument as soon we remove support to
  # activerecord-deprecated_finders.
  calculate(:average, column_name, options)
end

Вычисляет среднее значение по заданному столбцу. Возвращает nil если нет строк. См. calculate для примеров с параметрами.

Person.average(:age) # => 35.8

# File activerecord/lib/active_record/relation/calculations.rb, line 123
def calculate(operation, column_name, options = {})
  # TODO: Remove options argument as soon we remove support to
  # activerecord-deprecated_finders.
  if column_name.is_a?(Symbol) && attribute_alias?(column_name)
    column_name = attribute_alias(column_name)
  end

  if has_include?(column_name)
    construct_relation_for_association_calculations.calculate(operation, column_name, options)
  else
    perform_calculation(operation, column_name, options)
  end
end

Вычисляет агрегированные значения в заданном столбце. Методы для подсчета, суммы, среднего значения, минимума и максимума добавлены в качестве сокращений.

Существует два основных формата вывода:

* Single aggregate value: The single value is type cast to Integer for COUNT, Float
  for AVG, and the given column's type for everything else.

* Grouped values: This returns an ordered hash of the values and groups them. It
  takes either a column name, or the name of a belongs_to association.

    values = Person.group('last_name').maximum(:age)
    puts values["Drake"]
    # => 43

    drake  = Family.find_by(last_name: 'Drake')
    values = Person.group(:family).maximum(:age) # Person belongs_to :family
    puts values[drake]
    # => 43

    values.each do |family, max_age|
    ...
    end

Person.calculate(:count, :all) # The same as Person.count
Person.average(:age) # SELECT AVG(age) FROM people...

# Selects the minimum age for any family without any minors
Person.group(:last_name).having("min(age) > 17").minimum(:age)

Person.sum("2 * age")

# File activerecord/lib/active_record/relation/calculations.rb, line 38
def count(column_name = nil, options = {})
  if options.present? && !ActiveRecord.const_defined?(:DeprecatedFinders)
    raise ArgumentError, "Relation#count does not support finder options anymore. "                               "Please build a scope and then call count on it or use the "                               "activerecord-deprecated_finders gem to enable this functionality."

  end

  # TODO: Remove options argument as soon we remove support to
  # activerecord-deprecated_finders.
  calculate(:count, column_name, options)
end

Подсчитать записи.

Person.count
# => the total count of all people

Person.count(:age)
# => returns the total count of all people whose age is present in database

Person.count(:all)
# => performs a COUNT(*) (:all is an alias for '*')

Person.distinct.count(:age)
# => counts the number of different age values

Если count используется с group, возвращается Hash, ключи которого представляют агрегированный столбец, а значения — соответствующие количества:

Person.group(:city).count
# => { 'Rome' => 5, 'Paris' => 3 }

Если count используется с group для нескольких столбцов, возвращается Hash, ключи которого — массив, содержащий индивидуальные значения каждого столбца, а значение каждого ключа — count.

Article.group(:status, :category).count
# =>  {["draft", "business"]=>10, ["draft", "technology"]=>4,
       ["published", "business"]=>0, ["published", "technology"]=>2}

Если count используется с select, он подсчитает выбранные столбцы:

Person.select(:age).count
# => counts the number of different age values

Примечание: не все допустимые select выражения являются допустимыми count выражениями. Подробности зависят от базы данных. В недопустимых случаях возникает ошибка из базы данных.

# File activerecord/lib/active_record/relation/calculations.rb, line 195
def ids
  pluck primary_key
end

Извлечь все идентификаторы для связи, используя первичный ключ таблицы

Person.ids # SELECT people.id FROM people
Person.joins(:companies).ids # SELECT people.id FROM people INNER JOIN companies ON companies.person_id = people.id

# File activerecord/lib/active_record/relation/calculations.rb, line 77
def maximum(column_name, options = {})
  # TODO: Remove options argument as soon we remove support to
  # activerecord-deprecated_finders.
  calculate(:maximum, column_name, options)
end

Вычисляет максимальное значение в заданном столбце. Значение возвращается с тем же типом данных, что и столбец, или nil если нет строк. См. calculate для примеров с параметрами.

Person.maximum(:age) # => 93

# File activerecord/lib/active_record/relation/calculations.rb, line 66
def minimum(column_name, options = {})
  # TODO: Remove options argument as soon we remove support to
  # activerecord-deprecated_finders.
  calculate(:minimum, column_name, options)
end

Вычисляет минимальное значение в заданном столбце. Значение возвращается с тем же типом данных, что и столбец, или nil если нет строк. См. calculate для примеров с параметрами.

Person.minimum(:age) # => 7

# File activerecord/lib/active_record/relation/calculations.rb, line 170
def pluck(*column_names)
  column_names.map! do |column_name|
    if column_name.is_a?(Symbol) && attribute_alias?(column_name)
      attribute_alias(column_name)
    else
      column_name.to_s
    end
  end

  if has_include?(column_names.first)
    construct_relation_for_association_calculations.pluck(*column_names)
  else
    relation = spawn
    relation.select_values = column_names.map { |cn|
      columns_hash.key?(cn) ? arel_table[cn] : cn
    }
    result = klass.connection.select_all(relation.arel, nil, relation.arel.bind_values + bind_values)
    result.cast_values(klass.column_types)
  end
end

Используйте pluck в качестве сокращения для выбора одного или нескольких атрибутов без загрузки большого количества записей только для извлечения необходимых атрибутов.

Person.pluck(:name)

вместо

Person.all.map(&:name)

Pluck возвращает Array значений атрибутов, отформатированных в соответствии с именами столбцов, если их можно определить. Извлечение SQL-фрагмента по умолчанию возвращает значения типа String.

Person.pluck(:id)
# SELECT people.id FROM people
# => [1, 2, 3]

Person.pluck(:id, :name)
# SELECT people.id, people.name FROM people
# => [[1, 'David'], [2, 'Jeremy'], [3, 'Jose']]

Person.pluck('DISTINCT role')
# SELECT DISTINCT role FROM people
# => ['admin', 'member', 'guest']

Person.where(age: 21).limit(5).pluck(:id)
# SELECT people.id FROM people WHERE people.age = 21 LIMIT 5
# => [2, 3]

Person.pluck('DATEDIFF(updated_at, created_at)')
# SELECT DATEDIFF(updated_at, created_at) FROM people
# => ['0', '27761', '173']

# File activerecord/lib/active_record/relation/calculations.rb, line 88
def sum(*args)
  calculate(:sum, *args)
end

Вычисляет сумму значений в заданном столбце. Значение возвращается с тем же типом данных, что и столбец, 0, если нет строк. См. calculate для примеров с параметрами.

Person.sum(:age) # => 4562