Apresentação sobre o knex migrations (Migração de Banco de Dados), suas funcionalidades e dicas de como utilizar em seu projeto.

1. Knex Migrations
Ferramenta para controle de alterações na estrutura da base de dados.

2. Migrations File ([timestamp]_filename.js)
exports.up = function(knex, Promise) {
return knex.schema.createTable('migrationsTest', function(t)
{
t.increments('id').unsigned().primary().notNull();
t.text('description').nullable();
});
};
exports.down = function(knex, Promise) {
return knex.schema.dropTable('migrationsTest');
};
exports.up = function(knex, Promise) {
return knex.raw(`
alter table exemplo
add column descricao varchar;
`);
}
exports.down = function(knex, Promise)
{
return knex.raw(`
alter table exemplo
drop column descricao;
`);
}

3. Knex Config File (knexfile.js)
module.exports = {
local: {
client: 'mysql2',
connection: {
host: config.db_hostname,
database: config.db_defaultSchema,
user: config.db_user,
password: config.db_password,
},
migrations: {
tableName: 'migrations',
},
},
};

4. Tabela Migrations
Guarda quais scripts foram rodados
Quando foram rodados
Em qual lote foram rodados

5. Knex Migrations Api
Knex init - Cria o arquivo knexfile.js
Knex migrate:make filename - Cria o arquivo de migração com a timestamp e
nome informado.
Knex migrate:latest --env local - Roda a função up dos arquivos de migração
pendentes.
Knex migrate:rollback --env local - Roda a função down dos arquivos que foram
rodados no último comando de update.

6. Knex Migrate Package
Knex-migrate pending - lista todas as migrações pendentes
knex -migrate list - lista todas as migrações executadas
Knex-migrate up - executa todas as migrações pendentes
Knex-migrate down - desfaz a última migração
Knex-migrate rollback - desfaz o ultimo lote de migrações
Knex-migrate redo - desfaz o último lote de migrações e executa todas as
migrações novamente

7. Knex Migrate Options
--to, -t [filename] - executa as migrações até o arquivo informado
--from, -f [filename] - executa as migrações a partir do arquivo informado
--only, -o [filename] - executa apenas a migração do arquivo informado
--step, -s [number] - executa apenas o número informado de migrações
pendentes

8. Pontos Positivos
Reduz possíveis falhas humanas
Automatiza o processo de atualização de base
Facilita o teste de scripts de migrações

9. Cuidados
Comandos DDL ( CREATE, ALTER, DROP) não são reversíveis (mysql).

10. Pergunta
s?