Liquibase extension to support file-based changeset tracking rather than database-table based. When enabled, a CSV file is used instead of the DATABASECHANGELOG table.
These instructions will help you get the extension up and running on your local machine for development and testing purposes. This extension has a prerequisite of Liquibase core in order to use it. Liquibase core can be found at https://www.liquibase.org/download.
Download the latest released Liquibase extension .jar
file and place it in the liquibase/lib
install directory. If you want to use another location, specify the extension .jar
file in the classpath
of your liquibase.properties file.
Specify the Liquibase extension in the <dependency>
section of your POM file by adding the org.liquibase.ext
dependency for the Liquibase plugin.
<plugin>
<!--start with basic information to get Liquibase plugin:
include <groupId>, <artifactID>, and <version> elements-->
<groupId>org.liquibase</groupId>
<artifactId>liquibase-maven-plugin</artifactId>
<version>4.3.2</version>
<configuration>
<!--set values for Liquibase properties and settings
for example, the location of a properties file to use-->
<propertyFile>liquibase.properties</propertyFile>
</configuration>
<dependencies>
<!--set up any dependencies for Liquibase to function in your
environment for example, a database-specific plugin-->
<dependency>
<groupId>org.liquibase.ext</groupId>
<artifactId>liquibase-filechangelog</artifactId>
<version>${liquibase-filechangelog.version}</version>
</dependency>
</dependencies>
</plugin>
You can disable the extension logic by setting the system parameter "liquibase.ext.filechangelog.enabled" to "false".
The file to use can be set with the liquibase.ext.filechangelog.file
system property.
If not set, it defaults to "databasechangelog.csv" in the current working directory.
Liquibase Requirements: Requires Liquibase 3.1.0+
To file a bug, improve documentation, or contribute code, follow our guidelines for contributing.
This step-by-step instructions will help you contribute code for the extension.
Once you have created a PR for this extension you can find the artifact for your build using the following link: https://github.com/liquibase/liquibase-filechangelog/actions/workflows/build.yml.
Any issues can be logged in the Github issue tracker.
This project is licensed under the Apache License Version 2.0.