Migrações de banco de dados em Java: visão geral de ferramentas e bibliotecas

Migrações de banco de dados em Java: visão geral completa de ferramentas e bibliotecas

O desenvolvimento de aplicações Java modernas raramente ocorre sem o trabalho com bancos de dados relacionais. À medida que o projeto evolui, a estrutura do banco de dados (esquema) inevitavelmente muda: novas tabelas são adicionadas, colunas existentes são alteradas, índices ou restrições são introduzidos. A execução manual de scripts SQL em diferentes ambientes (desenvolvimento, teste, produção) leva a erros, dessincronização e perda de tempo. A solução para este problema são as migrações de banco de dados. Esta é uma forma automatizada de versionar e aplicar alterações no esquema.

No ecossistema Java, existem duas ferramentas dominantes para gerenciar migrações: Flyway e Liquibase. Ambas são soluções maduras e de código aberto, mas possuem abordagens diferentes para descrever as alterações. Neste artigo, analisaremos detalhadamente ambas as ferramentas, seus recursos, exemplos de uso e ajudaremos você a escolher a mais adequada para o seu projeto.

Por que são necessárias migrações de banco de dados?

Principais vantagens do uso de migrações:

• Versionamento de esquema: cada alteração é uma versão separada que pode ser rastreada no sistema de controle de versão (Git).
• Reprodutibilidade: qualquer desenvolvedor pode implantar o banco de dados atual com um único comando.
• Automação de implantação: as migrações são executadas automaticamente na inicialização da aplicação ou em pipelines CI/CD.
• Segurança: proteção contra a aplicação acidental repetida de alterações.
• Reversão de alterações: a maioria das ferramentas suporta "rollback" (reversão) de migrações.

Flyway: simplicidade e convenções

O Flyway segue a filosofia "convention over configuration" (convenção sobre configuração). As migrações são arquivos SQL comuns, nomeados de acordo com um modelo estrito: V{número}__{descrição}.sql. Por exemplo: V1__create_users.sql, V2__add_email_column.sql. O Flyway rastreia as migrações aplicadas em uma tabela especial flyway_schema_history.

Exemplo de uso do Flyway

1. Adicione a dependência no pom.xml (Maven):

<dependency>    <groupId>org.flywaydb</groupId>    <artifactId>flyway-core</artifactId>    <version>9.22.3</version></dependency>

2. Crie o arquivo de migração src/main/resources/db/migration/V1__create_users.sql:

CREATE TABLE users (    id BIGSERIAL PRIMARY KEY,    username VARCHAR(50) NOT NULL UNIQUE,    email VARCHAR(100) NOT NULL UNIQUE,    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP);

3. Configure e execute a migração no código Java:

import org.flywaydb.core.Flyway;

public class DatabaseMigrator {    public static void main(String[] args) {        Flyway flyway = Flyway.configure()            .dataSource("jdbc:postgresql://localhost:5432/mydb", "user", "password")            .load();        flyway.migrate();    }}

Após a execução, a tabela users e a tabela de serviço flyway_schema_history com um registro da versão 1 aparecerão no banco de dados.

Liquibase: flexibilidade e formatos

O Liquibase oferece uma abordagem mais flexível. As alterações podem ser descritas em três formatos: SQL, XML, YAML ou JSON. O conceito principal é o changelog (registro de alterações), que contém um conjunto de changesets (conjuntos de alterações). Cada changeset possui um identificador único (id) e um autor. O Liquibase suporta cenários mais complexos: pré-condições (preconditions), contextos (contexts) e rótulos (labels).

Exemplo de uso do Liquibase

1. Adicione a dependência no pom.xml:

<dependency>    <groupId>org.liquibase</groupId>    <artifactId>liquibase-core</artifactId>    <version>4.24.0</version></dependency>

2. Crie o arquivo changelog src/main/resources/db/changelog/db.changelog-master.xml:

<?xml version="1.0" encoding="UTF-8"?><databaseChangeLog    xmlns="http://www.liquibase.org/xml/ns/dbchangelog"    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"    xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog    http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-4.24.xsd">

    <changeSet id="1" author="developer">        <createTable tableName="users">            <column name="id" type="BIGINT" autoIncrement="true">                <constraints primaryKey="true" nullable="false"/>            </column>            <column name="username" type="VARCHAR(50)">                <constraints nullable="false" unique="true"/>            </column>            <column name="email" type="VARCHAR(100)">                <constraints nullable="false" unique="true"/>            </column>            <column name="created_at" type="TIMESTAMP" defaultValueComputed="CURRENT_TIMESTAMP"/>        </createTable>    </changeSet>

</databaseChangeLog>

3. Execute a migração no código Java:

import liquibase.Liquibase;import liquibase.database.Database;import liquibase.database.DatabaseFactory;import liquibase.database.jvm.JdbcConnection;import liquibase.resource.ClassLoaderResourceAccessor;

import java.sql.Connection;import java.sql.DriverManager;

public class LiquibaseMigrator {    public static void main(String[] args) throws Exception {        Connection connection = DriverManager.getConnection(            "jdbc:postgresql://localhost:5432/mydb", "user", "password"        );        Database database = DatabaseFactory.getInstance()            .findCorrectDatabaseImplementation(new JdbcConnection(connection));        Liquibase liquibase = new Liquibase(            "db/changelog/db.changelog-master.xml",            new ClassLoaderResourceAccessor(),            database        );        liquibase.update();    }}

O Liquibase criará as tabelas users e DATABASECHANGELOG (para rastrear alterações) e DATABASECHANGELOGLOCK (para gerenciamento de bloqueios).

Comparação: Flyway vs Liquibase

Ambas as ferramentas resolvem o mesmo problema, mas com filosofias diferentes. Aqui estão os principais critérios de comparação:

Qual ferramenta escolher?

A escolha entre Flyway e Liquibase depende das necessidades do seu projeto:

• Escolha Flyway se: você prefere simplicidade, trabalha principalmente com SQL puro e não precisa de lógica complexa de migração condicional.
• Escolha Liquibase se: você precisa de flexibilidade, suporte a vários formatos, rollback embutido, pré-condições ou integração com equipes não técnicas (que podem descrever alterações em YAML/XML).

Ambas as ferramentas são excelentes e amplamente utilizadas na indústria. O mais importante é usar uma delas em vez de gerenciar alterações de esquema manualmente.

Conclusão

As migrações de banco de dados são uma parte essencial do desenvolvimento moderno de aplicações Java. Ferramentas como Flyway e Liquibase ajudam a automatizar o versionamento de esquemas, garantindo consistência entre ambientes e simplificando o processo de implantação. Recomendamos começar com Flyway devido à sua simplicidade e, à medida que os requisitos se tornam mais complexos, considerar a migração para Liquibase.

Independentemente da ferramenta escolhida, lembre-se de versionar os arquivos de migração no Git, testar as migrações em um ambiente de desenvolvimento antes da produção e sempre fazer backup do banco de dados antes de aplicar alterações críticas.