Introdução ao Flyway e Configuração Básica

Introdução ao Flyway

O que é o Flyway?

Flyway é uma ferramenta de migração de banco de dados baseada em SQL e Java que permite gerenciar mudanças no esquema do banco de dados de forma confiável e controlada. Ele ajuda a garantir que o estado do banco de dados seja consistente entre diferentes ambientes (desenvolvimento, teste, produção) e equipes.

Principais Benefícios do Flyway:
  1. Controle de Versão: Organiza scripts de migração com números de versão para rastrear mudanças no banco de dados.
  2. Automação: Executa scripts de forma automatizada durante o desenvolvimento ou implantação.
  3. Compatibilidade Multibanco: Suporta uma ampla variedade de bancos de dados, como PostgreSQL, MySQL, SQL Server, Oracle, entre outros.
  4. Simplicidade: Configuração simples com base em convenções, mas com suporte a customizações avançadas.

Como o Flyway Funciona?

O Flyway usa scripts SQL ou Java codificados para realizar migrações. Ele mantém um histórico no banco de dados por meio de uma tabela especial chamada flyway_schema_history, onde registra todas as alterações aplicadas.

Conceitos-Chave:
  • Migration Scripts: Arquivos SQL ou Java que contêm mudanças a serem aplicadas.
  • Baseline: Um ponto inicial para começar a aplicar migrações em um banco de dados existente.
  • Repair: Repara a tabela de histórico do Flyway.
  • Clean: Remove todos os objetos do banco de dados (use com cautela).

Instalação do Flyway

Pré-requisitos:
  • Java instalado (JDK 8 ou superior).
  • Acesso a um banco de dados (PostgreSQL, MySQL, etc.).
  • Flyway CLI (ou integração com ferramentas como Maven ou Gradle).
Passo a Passo:
  1. Baixar e Instalar o Flyway CLI:
    • Acesse o site oficial do Flyway: Flyway Download.
    • Baixe a versão compatível com seu sistema operacional.
    • Extraia os arquivos para um diretório desejado.
  2. Configurar Variáveis de Ambiente:
    • Adicione o diretório flyway ao PATH do sistema.
  3. Verificar a Instalação: Execute o comando abaixo no terminal para verificar se o Flyway está instalado corretamente:

Resultado esperado: A versão instalada do Flyway será exibida.

Configuração Básica

1. Estrutura de Diretórios:

O Flyway segue uma estrutura de convenção para encontrar scripts de migração:

2. Criar o Arquivo de Configuração (flyway.conf):

No diretório do projeto, crie um arquivo chamado flyway.conf com os seguintes parâmetros básicos:

3. Criar Scripts de Migração:

No diretório sql, crie um script de exemplo chamado V1__Create_users_table.sql:

4. Aplicar a Migração:

Execute o comando:

O Flyway verificará os scripts no diretório configurado e aplicará as alterações ao banco de dados.


Atividade Prática:

  1. Instale o Flyway e configure um banco de dados local.
  2. Crie a estrutura de diretórios e o arquivo de configuração.
  3. Escreva e aplique o script V1__Create_users_table.sql.
  4. Verifique no banco de dados a tabela flyway_schema_history para confirmar que a migração foi aplicada com sucesso.

Links

Unlock the Future of Productivity with the A.I. Tools the Experts Don’t Want You to Know About!

Introdução ao Git