strict

Uses

If you set --strict to true, Liquibase requires the following:

• In all changesets, the author field must be non-empty

• Properties in the defaults file (liquibase.properties) must be valid

• LIQUIBASE_* environment variable names must be valid

It is a best practice to set --strict to true so that your changeset metadata is more useful and you can more easily tell if your properties and environment variables have problems. This lets you catch mistakes before you deploy your changes.

If you leave strict at its default setting of false, Liquibase ignores these requirements.

Liquibase 4.28.0 features

In Liquibase 4.28.0 and later, if you set --strict to true, Liquibase also checks for the existence of the following resource files:

• Defaults file (liquibase.properties)

• Files referenced in your changelog by sqlFile

• Files included in your changelog via include and includeAll

• Note: If you specify --strict as well as errorIfMissing (for include) or errorIfMissingOrEmpty (for includeAll), the values of errorIfMissing and errorIfMissingOrEmpty take precedence.

Liquibase 4.29.2 features

In Liquibase 4.29.2 and later, the / (forward slash) character is treated as a regular character when --strict=true and as a delimiter when --strict=false or not specified. For more information, see endDelimiter SQL attribute.

Liquibase 4.30.0 features

In Liquibase 4.30.0 and later, if --strict=true, Liquibase requires you to specify a tag that exists in your changelog when you run the update-to-tag command. If you specify a tag that does not exist, Liquibase halts.

Liquibase Secure 6.0 features

In Liquibase Secure 6.0 and later, if you set --strict to true, the validate command also reports changeset attributes that are defined but empty, including teams, releases, keywords, and conditions.

Syntax

You can set this parameter in the following ways:

For more information, see Working with command parameters

Output

Empty changeset author:

Unexpected error running Liquibase: Validation Failed: 1 changes have validation failures ChangeSet Author is empty, example-changelog.xml::1::

Invalid property in the liquibase.properties file:

Error parsing command line: Strict check failed due to undefined key(s) for 'status' command in file exists at path liquibase.properties': - 'invalid_property_name' To define keys that could apply to any command, prefix it with 'liquibase.command.' To disable strict checking, remove 'strict' from the file.

Invalid environment variable:

WARNING: Liquibase detected the following invalid LIQUIBASE_* environment variables: - LIQUIBASE_MADE_UP_VARIABLE Please rename them and run your command again, or set liquibase.strict=FALSE or LIQUIBASE_STRICT=FALSE. Find the list of valid environment variables at /pro/user-guide-4-33/what-are-liquibase-environment-variables Error parsing command line: Liquibase detected the following invalid LIQUIBASE_* environment variables: - LIQUIBASE_MADE_UP_VARIABLE Please rename them and run your command again, or set liquibase.strict=FALSE or LIQUIBASE_STRICT=FALSE. Find the list of valid environment variables at /pro/user-guide-4-33/what-are-liquibase-environment-variables