liquibase-schema-name

The liquibase-schema-name global parameter is a string that specifies the schema to use for the creation of Liquibase objects, like the DATABASECHANGELOG and DATABASECHANGELOGLOCK tracking tables.

Uses

If you are working in a multi-schema project, you can use liquibase-schema-name to separate the DATABASECHANGELOG and DATABASECHANGELOGLOCK tables from other Liquibase objects. This way, you will have a tracking schema and one or more managed schemas.

If you need to work in a test schema for your project, you can set liquibase-schema-name to control where Liquibase looks for the tracking tables during test runs.

Syntax

For more information, see Working with Command Parameters. You can set this parameter in the following ways:

Option Syntax
Liquibase properties file
liquibase.liquibaseSchemaName: <string>
Global CLI parameter
liquibase
 --liquibase-schema-name=<string> update
 --changelog-file=mychangelog.xml

JVM system property

JAVA_OPTS Environment Variable

macOS/Linux:
JAVA_OPTS=-Dliquibase.liquibaseSchemaName=<string>
Windows:
set JAVA_OPTS=-Dliquibase.liquibaseSchemaName=<string>
Liquibase Environment Variables macOS/Linux:
LIQUIBASE_LIQUIBASE_SCHEMA_NAME=<string>
Windows:
set LIQUIBASE_LIQUIBASE_SCHEMA_NAME=<string>

Note: These commands only apply to the current shell. To set permanent environment variables, see Liquibase Environment Variables.

Related links