insertMany
insertMany
is a Change Type in the Liquibase Open Source and Liquibase Pro extensions for MongoDB that inserts multiple documents into a collection.
Uses
The Liquibase Pro extension for MongoDB includes several modeled Change Types from the Liquibase Open Source version. These let you specify a few MongoDB commands using Liquibase XML, JSON, and YAML changelogs.
insertMany
is one such Change Type. You can use it to insert multiple documents into a collection in your database.
If you just want to insert a single document, use insertOne
instead.
Note: If you want to specify mongosh
statements in your XML, JSON, and YAML changelogs, use the mongo
and mongoFile
Change Types instead.
Run
To run this Change Type, follow these steps:
Add the Change Type to your changeset, as shown in the examples on this page.
Specify any required attributes. Use the table on this page to see which ones your database requires.
Deploy your changeset by running the
update
command:liquibase update
Available attributes
For more information, see db.collection.insertMany().
Tip: You must specify all top-level attributes marked as required. If you specify an optional attribute, you must also specify any nested attributes that it requires.
Name | Type | Description | Requirement |
| String | Name of the collection to insert objects into | Required |
| JSON object | JSON that defines the objects to insert | Required |
insertMany examples
databaseChangeLog:
- changeSet:
id: 2
author: your.name
changes:
- insertMany:
collectionName: countries_yaml
documents: |
[
{
_id : "us",
name : "United States",
exports : {
foods : [
{name : "bacon", tasty : "true" },
{name : "burger"}
]
}
},
{
_id : "ca",
name : "Canada",
exports : {
foods : [
{name : "bacon", tasty : false },
{name : "syrup", tasty : true}
]
}
},
{
_id : "mx",
name : "Mexico",
exports : {
foods : [
{name : "salsa", tasty : true, condiment : true}
]
}
}
]
- rollback:
runCommand:
command: |
{
delete: "countries_yaml",
deletes: [ { q: { }, limit: 0 } ]
}