Skip to content

Latest commit

 

History

History
63 lines (45 loc) · 3.33 KB

README.md

File metadata and controls

63 lines (45 loc) · 3.33 KB

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.