модуль ActiveRecord::Calculations

# File activerecord/lib/active_record/relation/calculations.rb, line 59
def average(column_name)
  calculate(:average, column_name)
end

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

Person.average(:age) # => 35.8

# File activerecord/lib/active_record/relation/calculations.rb, line 131
def calculate(operation, column_name)
  if has_include?(column_name)
    relation = apply_join_dependency

    if operation.to_s.downcase == "count"
      relation.distinct!
      # PostgreSQL: ORDER BY expressions must appear in SELECT list when using DISTINCT
      if (column_name == :all || column_name.nil?) && select_values.empty?
        relation.order_values = []
      end
    end

    relation.calculate(operation, column_name)
  else
    perform_calculation(operation, column_name)
  end
end

Вычисляет агрегированные значения в заданном столбце. Методы для count, sum, average, minimum и maximum добавлены как сокращения.

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")

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

• Единственное агрегированное значение: единственное значение приводится к типу Integer для COUNT, Float для AVG и типу заданного столбца для всех остальных случаев.

• Сгруппированные значения: это возвращает упорядоченный массив значений и группирует их. Это принимает имя столбца или имя ассоциации belongs_to.

  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

# File activerecord/lib/active_record/relation/calculations.rb, line 41
def count(column_name = nil)
  if block_given?
    unless column_name.nil?
      ActiveSupport::Deprecation.warn \
        "When `count' is called with a block, it ignores other arguments. " \
        "This behavior is now deprecated and will result in an ArgumentError in Rails 6.0."
    end

    return super()
  end

  calculate(:count, column_name)
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 используется с Relation#group, возвращается Hash, ключи которого представляют агрегированный столбец, а значения — соответствующие значения:

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

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

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

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

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

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

# File activerecord/lib/active_record/relation/calculations.rb, line 207
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)
  calculate(:maximum, column_name)
end

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

Person.maximum(:age) # => 93

# File activerecord/lib/active_record/relation/calculations.rb, line 68
def minimum(column_name)
  calculate(:minimum, column_name)
end

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

Person.minimum(:age) # => 7

# File activerecord/lib/active_record/relation/calculations.rb, line 184
def pluck(*column_names)
  if loaded? && (column_names.map(&:to_s) - @klass.attribute_names - @klass.attribute_aliases.keys).empty?
    return records.pluck(*column_names)
  end

  if has_include?(column_names.first)
    relation = apply_join_dependency
    relation.pluck(*column_names)
  else
    enforce_raw_sql_whitelist(column_names)
    relation = spawn
    relation.select_values = column_names.map { |cn|
      @klass.has_attribute?(cn) || @klass.attribute_alias?(cn) ? arel_attribute(cn) : cn
    }
    result = skip_query_cache_if_necessary { klass.connection.select_all(relation.arel, nil) }
    result.cast_values(klass.attribute_types)
  end
end

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

Person.pluck(:name)

вместо

Person.all.map(&:name)

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

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

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

Person.distinct.pluck(: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']

См. также ids.

# File activerecord/lib/active_record/relation/calculations.rb, line 86
def sum(column_name = nil)
  if block_given?
    unless column_name.nil?
      ActiveSupport::Deprecation.warn \
        "When `sum' is called with a block, it ignores other arguments. " \
        "This behavior is now deprecated and will result in an ArgumentError in Rails 6.0."
    end

    return super()
  end

  calculate(:sum, column_name)
end

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

Person.sum(:age) # => 4562