HSQLDB

• Verified Versions: 2.7
• Maintainer: Redgate

Supported Versions and Support Levels

• For information regarding the supported version and support levels available, please see Supported Databases for Flyway
• For information regarding the Flyway features available, please see Flyway feature glossary

Driver

Java Usage

HSQLDB support is a separate dependency for Flyway and will need to be added to your Java project to access these features. HSQLDB is found within the flyway-database-hsqldb plugin module.

Maven

Redgate

<dependency>
    <groupId>com.redgate.flyway</groupId>
    <artifactId>flyway-database-hsqldb</artifactId>
</dependency>

Open source

<dependency>
    <groupId>org.flywaydb</groupId>
    <artifactId>flyway-database-hsqldb</artifactId>
</dependency>

Gradle

Redgate

dependencies {
    implementation "com.redgate.flyway:flyway-database-hsqldb"
}

Open source

dependencies {
    implementation "org.flywaydb:flyway-database-hsqldb"
}

SQL Script Syntax

• Standard SQL syntax with statement delimiter ;
• Triggers with BEGIN ATOMIC ... END; block

Compatibility

• DDL exported by HSQLDB can be used unchanged in a Flyway migration
• Any HSQLDB SQL script executed by Flyway, can be executed by the Hsql tools (after the placeholders have been replaced)

Example

/* Single line comment */
CREATE TABLE test_data (
  value VARCHAR(25) NOT NULL PRIMARY KEY
);

/*
Multi-line
comment
*/

-- Sql-style comment

-- Placeholder
INSERT INTO ${tableName} (name) VALUES ('Mr. T');

CREATE TRIGGER uniqueidx_trigger BEFORE INSERT ON usertable
	REFERENCING NEW ROW AS newrow
    FOR EACH ROW WHEN (newrow.name is not null)
	BEGIN ATOMIC
      IF EXISTS (SELECT * FROM usertable WHERE usertable.name = newrow.name) THEN
        SIGNAL SQLSTATE '45000' SET MESSAGE_TEXT = 'duplicate name';
      END IF;
    END;

Limitations

• No concurrent migration support (to make Flyway cluster-safe) with HSQLDB 1.8, as this version does not properly support SELECT ... FOR UPDATE locking