bulk-set

Note: This is a Liquibase Pro command, so you need a Liquibase Pro License Key to use it.

The bulk-set subcommand sets all qualifying quality checks to the same value. It helps you perform bulk management operations without running similar checks commands multiple times.

Uses

The bulk-set command allows you to modify all qualifying quality checks at once using the --enable, --disable, and --severity flags.

For example, in a few commands, you can disable all your quality checks, set all severity exit codes to 0, and then pick a couple of them to enable and set the appropriate severity level. Let’s say you have 30 quality checks with different priorities. However, you want to reset them all to have a severity of 0 and configure only a few to have a severity of 4, which you have set in your CI/CD tool as an exit code that stops your jobs. This way, you would run liquibase checks bulk-set --severity=4.

Note: You cannot enable the checks that do not have the default value. You need to copy and customize them first.

Note: To view a list of available checks, run liquibase checks show.

Running the bulk-set command

Tip: For best results, specify all commands and parameters with the --kebab-case format in the CLI. If your preference is camelCase, it will still work in the CLI.

You can run the bulk-set command as follows:

liquibase checks bulk-set --disable
liquibase checks bulk-set --enable
liquibase checks bulk-set --severity=[INFO|MINOR|MAJOR|CRITICAL|BLOCKER]
liquibase checks bulk-set --severity=[0|1|2|3|4]

Note: If you have a checks settings file customized for a specific environment or project, you need to pass that using the --checks-settings-file parameter. If you do not include this parameter, Liquibase uses the default settings file: liquibase.checks-settings.conf.

The command is interactive, so to skip the confirmation in automation, use the --force flag with another bulk-set flag.

liquibase checks bulk-set --severity=INFO --force

You can pass only one flag at a time. For example, to enable checks and set them to severity=MINOR, run two bulk-set commands, as follows.

Example: liquibase checks bulk-set --enable
liquibase checks bulk-set --severity=MINOR

Tip: Specify the --auto-update parameter if you want to allow automatic backup and updating of the liquibase.check-settings.conf file when new quality checks are available:
CLI: --auto-update=[on|off]
Property: liquibase.command.checks.bulkset.autoUpdate: [on|off]
Environment Variable: LIQUIBASE_COMMAND_CHECKS_BULKSET_AUTO_UPDATE=[ON|OFF]

Related links