- Defined in:
permalink.import(*args) ⇒ Object
Imports a collection of values to the database.
This is more efficient than using ActiveRecord::Base#create or ActiveRecord::Base#save multiple times. This method works well if you want to create more than one record at a time and do not care about having ActiveRecord objects returned for each record inserted.
This can be used with or without validations. It does not utilize the ActiveRecord::Callbacks during creation/modification while performing the import.
Model.import array_of_models Model.import column_names, array_of_values Model.import column_names, array_of_values,
With this form you can call import passing in an array of model objects that you want updated.
Model.import column_names, array_of_values
The first parameter column_names is an array of symbols or strings which specify the columns that you want to update.
The second parameter, array_of_values, is an array of arrays. Each subarray is a single set of values for a new record. The order of values in each subarray should match up to the order of the column_names.
Model.import column_names, array_of_values, options
The first two parameters are the same as the above form. The third parameter, options, is a hash. This is optional. Please see below for what options are available.
- validate – true|false, tells import whether or not to use \
ActiveRecord validations. Validations are enforced by default.
- on_duplicate_key_update – an Array or Hash, tells import to \
use MySQL's ON DUPLICATE KEY UPDATE ability. See On Duplicate\ Key Update below.
- synchronize – an array of ActiveRecord instances for the model that you are currently importing data into. This synchronizes existing model instances in memory with updates from the import.
- timestamps – true|false, tells import to not add timestamps \ (if false) even if record timestamps is disabled in ActiveRecord::Base
- +recursive – true|false, tells import to import all autosave association if the adapter supports setting the primary keys of the newly imported objects.