Banco de Dados Evolutivo – Parte 14

Esse é o último post da série Banco de Dados Evolutivo. Nessa etapa você irá migrar a base de dados de Produção para a versão 2 e aprenderá como executar o comando ROLLBACK <versão>.

---

Depois de ter desnormalizado a base de dados de Homologação da Adventure Works (veja o a Parte 13 do conjunto de posts da série) será necessário adicionar à tabela databasechangelog a nova versão do database.

Para isso, assim como já fora feito na versão 1.0 (veja a Parte 12) , será necessário criar um arquivo XML de nome changelog_2.xml que atribuirá à nova modificação de sistema a versão 2.0 – use o código da Listagem 1.

<databaseChangeLog
        xmlns="http://www.liquibase.org/xml/ns/dbchangelog"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xmlns:ext="http://www.liquibase.org/xml/ns/dbchangelog-ext"
        xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog 
		http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-2.0.xsd
        http://www.liquibase.org/xml/ns/dbchangelog-ext 
http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-ext.xsd">

<changeSet author="arthur" id="tagDatabase-versao_2.0">
    <tagDatabase tag="versao_2.0"/>
</changeSet>

</databaseChangeLog>

Listagem 1. Comando usado para criação do arquivo changelog_2.xml que adicionará à tabela databasechangeset a versão 2 do sistema da Adventure Works.

Altere também o arquivo master_2.0.xml para que seja possível a execução da nova refatoração através do código da Listagem 2.

<databaseChangeLog
       xmlns="http://www.liquibase.org/xml/ns/dbchangelog"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:ext="http://www.liquibase.org/xml/ns/dbchangelog-ext"
       xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog 
http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-2.0.xsd
       http://www.liquibase.org/xml/ns/dbchangelog-ext 
http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-ext.xsd">

<include file="C:/changelog/versao_2.0/changelog_1.xml" />
<include file="C:/changelog/versao_2.0/changelog_2.xml" />

</databaseChangeLog> 

Listagem 2. Comando usado dentro do arquivo XML master_2.0.xml.

Como você já deve estar familiarizado, abra o cmd e, a partir da pasta raiz de sistema, execute o update na base de homologação através do Liquibase usando o código da Listagem 3.

java -jar C:\liquibase-3.0.8-bin\liquibase.jar --defaultsFile=C:\liquibase-3.0.8-bin\liquibaseHomolog.properties update

Listagem 3. Comando usado no cmd para execução do comando UPDATE através do Liquibase em ambiente de Homologação.

Caso seja executado um SELECT na tabela de controle databasechangelog, será possível observar que a base de Homologação já se encontra em sua segunda versão conforme a Figura 1.

Figura 1. Retorno do SELECT na tabela databasechangelog após adição da versão 2.

Atualizando a Base de Dados de Produção – Versão 2

Nesse momento, depois de testada a ultima alteração em ambiente de homologação, será necessário atualizar a base de Produção para a ultima versão desenvolvida. Para isso, utilize o comando da Listagem 4.

java -jar C:\liquibase-3.0.8-bin\liquibase.jar --defaultsFile=C:\liquibase-3.0.8-bin\liquibaseProd.properties update

Listagem 4. Comando usado no cmd para execução do comando UPDATE através do Liquibase em ambiente de Produção.

Caso seja executado um SELECT na tabela databasechangelog em ambiente de Produção você verá que, assim como em Homologação, o sistema encontra-se na Versão 2.

O Comando Rollback <versão>

Nesse momento suponha o seguinte: Por algum motivo, será necessário que o sistema volte a ser normalizado contendo novamente os dados de tipo de telefone na tabela Person.PhoneNumberType. Dessa forma será necessário que voltemos o Banco para a Versão anterior, a versão 1, logo, esta contêm a estrutura DDL e DML anterior do banco.

Para que isso seja possível precisaremos executar um comando muito simples. Passaremos os parâmetros de conexão do Banco de Produção seguido do comando rollback <versao>.

O Liquibase irá até a tabela databasechangelog e verá quais as refatorações que não estão contidas na versão fornecida como parâmetro e executará o Rollback de todas elas. Porém é necessário lembrar do que foi mencionado na Parte 13 do conjunto de posts. Se a refatoração usada não possuir Auto Rollback, é preciso que você adicione a tag <rollback> … </rollback> e crie a refatoriação contrária. Caso contrário, não será possível desfazer o que está feito na versão atual.

Execute o comando da Listagem 5 para execução do Rollback <versao>.

java -jar C:/liquibase-3.0.8-bin/liquibase.jar --defaultsFile=C:/liquibase-3.0.8-bin/liquibaseProd.properties rollback versao_1.0

Listagem 5. Comando usado no cmd para execução do comando ROLLBACK <versão>. Através é possível retroceder até uma versão anterior desejada.

Conforme já vimos na primeira refatoração que executamos (veja a Parte 7 do conjunto de posts), é necessário que o arquivo XML que contenha a refatoração desfeita seja retirado do arquivo pai da versão (nesse caso o arquivo master_2.0.xml). Caso contrário a refatoração será reexecutada quando uma nova mudança for inserida.

---

Conclusão

O Liquibase é uma poderosa ferramenta de versionamento de Banco de Dados. Ela não se resume somente a isso que foi exposto nessa série de 14 posts. Esse foi somente um simples overview do que é possível fazer através dela (para mais informações consulte a documentação oficial da ferramenta).

Adaptando as técnicas citadas nos Partes 01, 02, 03 e 04 ao seu negócio e usando corretamente o Liquibase como fora ensinado da etapa 05 à 14 dos posts será possível gerenciar o versionamento de qualquer banco de dados, em qualquer ambiente, facilitando, dessa forma, o controle de versão de seu sistema como um todo.