Skip to content

Liquibase extension to use a local file to track changes rather than a table

Notifications You must be signed in to change notification settings

liquibase/liquibase-filechangelog

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

liquibase-filechangelog Build and Test Extension

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.

Configuring the extension

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.

Liquibase CLI

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.

Maven

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+

Contribution

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.

Issue Tracking

Any issues can be logged in the Github issue tracker.

License

This project is licensed under the Apache License Version 2.0.

About

Liquibase extension to use a local file to track changes rather than a table

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages