Bulk Insert gem 使用指南

Bulk Insert gem 使用指南

bulk_insertEfficient bulk inserts with ActiveRecord项目地址:https://gitcode.com/gh_mirrors/bu/bulk_insert

1. 项目介绍

Bulk Insert 是一个 Ruby 框架，用于高效地批量插入数据到数据库中，特别是对 Rails 用户而言。在Rails 6之前，它提供了一种比 insert_all 更快的解决方案来处理大量数据导入。通过这个库，开发者可以避免频繁的数据库交互，从而提高性能并减少事务成本。

2. 项目快速启动

首先，你需要将 Bulk Insert 添加到你的 Gemfile 中：

gem 'bulk_insert'

然后运行 bundle install 安装依赖。

接下来，你可以创建一个 Worker 实例并添加数据，如下所示：

require 'active_record'
require 'bulk_insert'

class Book < ActiveRecord::Base
end

books_data = [
  { title: 'Book1', author: 'Author1' },
  { title: 'Book2', author: 'Author2' }
]

BulkInsert.into(Book) do |worker|
  books_data.each do |book|
    worker.add(book)
  end
end

上面的代码将会把数组中的书对象一次性插入到数据库中。

3. 应用案例和最佳实践

批量保存

你可以控制批处理大小以优化性能：

 BulkInsert.into(Book, set_size: 100) do |worker|
   # ...
 end

这将确保每次插入最多100行数据。

返回主键

如果你需要插入后的主键值，可以设置 return_primary_keys：

result_sets = BulkInsert.into(Book, return_primary_keys: true) do |worker|
  # ...
end

primary_keys = result_sets.flat_map(&:first)

事务处理

最好在执行批量插入时包裹在一个事务中，以确保数据的一致性：

ActiveRecord::Base.transaction do
  BulkInsert.into(Book) do |worker|
    # ...
  end
end

4. 典型生态项目

Bulk Insert 支持多种数据库适配器，包括 SQLite、MySQL 和 PostgreSQL。这意味着它可以无缝集成到使用这些数据库的任何 Rails 应用中。

此外，由于 Rails 6 引入了 insert_all 方法，对于较新版本的 Rails，你可能需要权衡是否继续使用 Bulk Insert 或转向原生的 insert_all。在决定之前，可以评估两者的性能差异以找到最适合你应用的方法。

---

请注意，本指南基于提供的 GitHub 链接以及对相关文档的理解。如果有新的更新或变化，建议查看项目仓库的最新说明。

bulk_insertEfficient bulk inserts with ActiveRecord项目地址:https://gitcode.com/gh_mirrors/bu/bulk_insert