bootique-examples / bootique-liquibase-examples

bootique-liquibase-demo

A simple example that explains how to migrate data via Liquibase integrated for Bootique.

For additional help/questions about this example send a message to Bootique forum.

You can find different versions of framework in use at

• 1.x
• 2.x

Prerequisites

* Java 1.8 or newer.
* Apache Maven.

Build the Demo

Here is how to build it:

git clone [e-mail]:bootique-examples/bootique-liquibase-demo.git        
cd bootique-liquibase-demo
mvn package

Run the Demo

Now you can check the options available in your app:

java -jar target/bootique-liquibase-demo-1.0-SNAPSHOT.jar

OPTIONS
    --changelog-sync
           Mark all changes as executed in the database.

    --clear-check-sums
        Clears all checksums in the current changelog, so they will be
        recalculated next update.

    --config=yaml_location
        Specifies YAML config location, which can be a file path or a URL.

    -h, --help
        Prints this message.

    -H, --help-config
        Prints information about application modules and their configuration
        options.

    -u, --update
        Updates DB with available migrations

    -v, --validate
        Checks the changelog for errors.

Provide required configuration via config1.yml:

jdbc:
  test:
    url: jdbc:derby:target/derby/migrations1;create=true
    maxActive: 2

liquibase:
  datasource: test
  # changelog provided in java

Run migration:

java -jar target/bootique-liquibase-demo-1.0-SNAPSHOT.jar --config=classpath:io.bootique.liquibase.demo/config1.yml --lb-update

Check data via --select-test command:

java -jar target/bootique-liquibase-demo-1.0-SNAPSHOT.jar --config=classpath:io.bootique.liquibase.demo/config1.yml --select-test

Newly created table "TEST" data is successfully printed:

...
    ID : 1
    NAME : Test Name
    ORDER : 1

Noticeable point is "last wins" strategy, returning the last change log collection passed to Liquibase. Consider configuration config2.yml:

jdbc:
  test:
    url: jdbc:derby:target/derby/migrations1;create=true
    maxActive: 2

liquibase:
  datasource: test
  changeLogs: # change log is declared directly in the file
    - classpath:io.bootique.liquibase.demo/changelog_1_2.yml

Firstly, rebuild simply having called:

mvn clean package

Then run migration with config2.yml:

java -jar target/bootique-liquibase-demo-1.0-SNAPSHOT.jar --config=classpath:io.bootique.liquibase.demo/config2.yml --lb-update

Check data via --select-test command:

java -jar target/bootique-liquibase-demo-1.0-SNAPSHOT.jar --config=classpath:io.bootique.liquibase.demo/config2.yml --select-test        

Expected result is error since "TEST" table created in changelog_2.xml overridden by YAML config:

...
    Caused by: ERROR 42X05: Table/View 'TEST' does not exist.
    	at org.apache.derby.iapi.error.StandardException.newException(Unknown Source)