5.10.1. Liquibase
5.10.1.1. Purpose
Liquibase is used to manage database schema changes.
5.10.1.2. Website
5.10.1.3. Buildsets involved
liquibase_changesets
By running this build set the MetaFactory tool will generate Liquibase change sets in directory [project]\[backend]\src\main\resources\liquibase.
5.10.1.4. Usage
At MetaFactory database schema changes are manually placed in a specific file called:
[project]\[backend]\src\main\resources\config\liquibase\liquibase-alters-changeLog.xml
Whenever the backend is started, any changes that have not been applied yet to the database will be made by Liquibase.
Important
The Liquibase alters changelog liquibase-alters-changeLog.xml is a hand-written file. The MetaFactory tool does generate Liquibase change sets, but these change sets are not incremental change sets. To make sure the change sets are incremental, the content of these generated change sets have to manually copied or converted into the liquibase-alters-changeLog.xml file. For more information about Liquibase see the Liquibase-Homepage.
Note
Each change set in liquibase-alters-changeLog.xml has an id. This id is based upon a Jira issue.
Warning
Never change an existing changeSet in `liquibase-alters-changeLog.xml` as this will prevent the backend application from starting!