Contents

# MassInsert [![Build Status](https://travis-ci.org/alejandrogutierrez/mass_insert.png?branch=master)](https://travis-ci.org/alejandrogutierrez/mass_insert) [![Coverage Status](https://coveralls.io/repos/alejandrogutierrez/mass_insert/badge.png)](https://coveralls.io/r/alejandrogutierrez/mass_insert)

This gem aims to provide an easy and faster way to do single database insertions in Rails.
Support Mysql, PostgreSQL and SQLite3 adapters. It depends on ActiveRecord.


## Installation
Add this line to your application's Gemfile:
```ruby
gem 'mass_insert'
```
Run the bundle command to install it.


## Advantages
Faster. It's depending of the computer but these are some results...
* PostgreSQL - Saving 10,000 records in 0.49s


## Attention
Since this is a single database insertion your model validations will be ignored,
then if you use this gem you need to be sure that information is OK to be persisted.


## Basic Usage
To use MassInsert gem you need to call `mass_insert` method from your ActiveRecord model
and pass it an array with the values that you want to persist into the database.
```ruby
values = [
  {
    name:   'Jay',
    email:  '[e-mail]',
    age:    15
  },
  {
    name:   'Beverly',
    email:  '[e-mail]',
    age:    24
  }
]

User.mass_insert(values)
```


## Insertion per batches
Due you can get a database timeout error you can specify that the insertion will be in batches.
Just pass the `per_batch` option with the records per batch. Example...
```ruby
User.mass_insert(values, per_batch: 1000)
```


## Contributing
1. Fork it
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Add some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create new Pull Request

Version data entries

1 entries across 1 versions & 1 rubygems

Version	Path
mass_insert-0.2.0	README.md