Using Liquibase with Informix

IBM Informix is an embeddable relational database management system that specializes in online transaction processing and data warehouse workflows. For more information, see IBM Informix Servers Documentation.

Prerequisites

  • Created an Informix database in the ANSI mode to enable implicit transactions by using the following statement:
  • CREATE DATABASE ansiDatabase WITH LOG MODE ANSI;

    For more information, see CREATE DATABASE statement: Logging Options.

Install Drivers

To use Liquibase and Informix, you must download the JDBC driver JAR file.

Place your JAR file(s) in the liquibase/lib directory. For more information, see Adding and Updating Liquibase Drivers.

If you use Maven, you also need to download the driver JAR file and configure your Maven pom.xml file to use the local copy of the driver. For more information, see Configuring Liquibase Attributes in your Maven POM File. For example:

<dependency>
    <groupId>com.ibm.informix</groupId>
    <artifactId>jdbc</artifactId>
    <version>4.50.8</version>
</dependency>

Test Your Connection

For Liquibase and Informix to work, you need to:

  1. Ensure your Informix database is configured. See Informix Installation for more information.
  2. Specify the database URL in the Liquibase properties file:
  3. url: jdbc:informix-sqli://localhost:9088/dbname:INFORMIXSERVER=dbserver
  4. Create a text file called changelog (.xml, .sql, .json, or .yaml) in your project directory and add a changeset.
  1. Navigate to your project folder in the CLI and run the Liquibase status command to see whether the connection is successful. You can pass arguments in the CLI or keep them in the Liquibase properties file.
  2. liquibase --username=test --password=test --changelog-file=<changelog.xml> status
  3. Inspect the SQL with the update-sql command. Then make changes to your database with the update command.
  4. liquibase --changelog-file=<changelog.xml> update-sql
    liquibase --changelog-file=<changelog.xml> update

From a database UI tool, ensure that your database contains the table you added along with the DATABASECHANGELOG table and DATABASECHANGELOGLOCK table.

If you add a changeset with the procedure but receive an error message during the runtime, add the splitStatements attribute set to false to your changeset as follows:

--changeset bob:5 splitStatements:false
CREATE PROCEDURE raise_prices ( per_cent INT)
        UPDATE stock SET unit_price = unit_price + (unit_price * (per_cent/100) );
END PROCEDURE;