deac/activerecord-import
1
0
Fork 0
Code Issues Pull requests Releases Wiki Activity

Updating README to point to wiki

Browse source
This commit is contained in:
Zach Dennis 2010-08-21 12:44:48 -04:00
parent 83c3dedf96
commit f61eabda19
1 changed files with 2 additions and 23 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

25
README.markdown
View file

@ -1,29 +1,8 @@
# activerecord-import
activerecord-import is a library for bulk inserting data using ActiveRecord. By default with ActiveRecord, in order to insert multiple records you have to perform individual save operations on each model, like so:
activerecord-import is a library for bulk inserting data using ActiveRecord.
10.times do |i|
Book.create! :name => "book #{i}"
end
This may work fine if all you have is 10 records, but if you have hundreds, thousands, or millions of records it can turn into a nightmare. This is where activerecord-import comes into play. Here's the equivalent behaviour using the #import method:
books = []
10.times{ |i| books << Book.new(:name => "book #{i}") }
Book.import books
Pretty slick, eh?
Maybe, just maybe you're thinking, why do I have do instantiate ActiveRecord objects? Will that perform validations? What if I don't want validations? What if I want to take advantage of features like MySQL's on duplicate key update? Well, activerecord-import handles all of these cases and more!
For more documentation on the matter you can refer to two places:
1. activerecord-import github wiki: http://wiki.github.com/zdennis/activerecord-import/
1. the tests in the code base
# Upgrading from ar-extensions
This library replaces the ar-extensions library and is compatible with Rails 3. It provides the exact same API for importing data, but it does not include any additional ar-extensions functionality.
For more information on activerecord-import please see its wiki: http://wiki.github.com/zdennis/activerecord-import/
# License