--sqlplus-fail-options

Last updated: June 11, 2026

Only for SQL Plus users who have a changeset with the runWith:sqlplus attribute. This is a runWith native-executor specific flag. When it is set to any value other than none, the Liquibase job fails and the SQL Plus warning or error appears.

Value options:

all = stop Liquibase for either warning or error
warning = stop Liquibase for only warnings
error = stop Liquibase for errors
none = do not stop Liquibase job for warning or error, but do keep on surfacing the warning or errors as we currently do

Syntax

You can set this parameter in the following ways:

Option	Syntax
Global CLI parameter	`--sqlplus-fail-options=<string>`
Liquibase properties file (defaults file)	`liquibase.sqlplus.fail.options: <string>`
Global flow file argument (example)	`globalArgs: { sqlplus-fail-options: "<string>" }`
JVM system property (JAVA_OPTS environment variable)	`JAVA_OPTS=-Dliquibase.sqlplus.fail.options=<string>`
Liquibase environment variable	`LIQUIBASE_SQLPLUS_FAIL_OPTIONS=<string>`