@mediasuite/loopback-db-migrate
v1.1.0
Published
A library to add simple database migration support to loopback projects. Migrations that have been run will be stored in a table called 'Migrations'. The library will read the loopback datasources.json files based on the NODE_ENV environment variable just
Downloads
496
Readme
A library to add simple database migration support to loopback projects. Migrations that have been run will be stored in a table called 'Migrations'. The library will read the loopback datasources.json files based on the NODE_ENV environment variable just like loopback does. The usage is based on the node-db-migrate project.
NOTE: This does not currently work with the loopback in memory DB.
Down migrations are run in reverse run order.
Options: --datasource specify database name (optional, default: db) --since specify date to run migrations from (optional, default: run all migrations) --count specify number of migrations to run from current state (optional, default: run all migrations)
<h2>Using the CLI directly</h2>
Run all new migrations that have not previously been run, using datasources.json and database 'db':
```javascript
./node_modules/loopback-db-migrate/loopback-db-migrate.js up
Run all new migrations since 01012014 that have not previously been run, using datasources.json and datasources.qa.json and database 'my_db_name':
NODE_ENV=qa ./node_modules/loopback-db-migrate/loopback-db-migrate.js up --datasource my_db_name --since 01012014
Rollback the previous migration that was run, using datasources.json and datasources.qa.json and database 'my_db_name':
NODE_ENV=qa ./node_modules/loopback-db-migrate/loopback-db-migrate.js down --datasource my_db_name --count 1
npm run-script migrate-db-up npm run-script migrate-db-down
NODE_ENV=production npm run-script migrate-db-up NODE_ENV=production npm run-script migrate-db-down
<h2>Example migrations</h2>
```javascript
module.exports = {
up: function(dataSource, next) {
dataSource.models.Users.create({ ... }, next);
},
down: function(dataSource, next) {
dataSource.models.Users.destroy({ ... }, next);
}
};
/* executing raw sql */
module.exports = {
up: function(dataSource, next) {
dataSource.connector.query('CREATE TABLE `my_table` ...;', next);
},
down: function(dataSource, next) {
dataSource.connector.query('DROP TABLE `my_table`;', next);
}
};