class ActiveRecord::Batches::BatchEnumerator

# File activerecord/lib/active_record/relation/batches/batch_enumerator.rb, line 49
def delete_all
  sum(&:delete_all)
end

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

Person.in_batches.delete_all

См. Relation#delete_all для подробностей о том, как каждая порция удаляется.

# File activerecord/lib/active_record/relation/batches/batch_enumerator.rb, line 69
def destroy_all
  each(&:destroy_all)
end

Удаляет записи порциями.

Person.where("age < 10").in_batches.destroy_all

См. Relation#destroy_all для подробностей о том, как каждая порция уничтожается.

# File activerecord/lib/active_record/relation/batches/batch_enumerator.rb, line 78
def each
  enum = @relation.to_enum(:in_batches, of: @of, start: @start, finish: @finish, load: false)
  return enum.each { |relation| yield relation } if block_given?
  enum
end

Возвращает объект ActiveRecord::Relation для каждой порции записей.

Person.in_batches.each do |relation|
  relation.update_all(awesome: true)
end

# File activerecord/lib/active_record/relation/batches/batch_enumerator.rb, line 36
def each_record
  return to_enum(:each_record) unless block_given?

  @relation.to_enum(:in_batches, of: @of, start: @start, finish: @finish, load: true).each do |relation|
    relation.records.each { |record| yield record }
  end
end

Итерация по коллекции записей из базы данных (например, с помощью метода all) является очень неэффективной, так как она будет пытаться создать все объекты сразу.

В этом случае методы пакетной обработки позволяют работать с записями по частям, тем самым значительно снижая потребление памяти.

Person.in_batches.each_record do |person|
  person.do_awesome_stuff
end

Person.where("age > 21").in_batches(of: 10).each_record do |person|
  person.party_all_night!
end

Если вы не предоставите блок методу each_record, он вернет Enumerator для цепочки с другими методами:

Person.in_batches.each_record.with_index do |person, index|
  person.award_trophy(index + 1)
end

# File activerecord/lib/active_record/relation/batches/batch_enumerator.rb, line 58
def update_all(updates)
  sum do |relation|
    relation.update_all(updates)
  end
end

Обновляет записи порциями. Возвращает общее количество затронутых строк.

Person.in_batches.update_all("age = age + 1")

См. Relation#update_all для подробностей о том, как каждая порция обновляется.