Troubleshooting your check chain

Disabled or deleted check

If you add a check to a chain that is not enabled and you run the chain, you will receive a message that states:

This chain is broken! Check '<TableCommentPatternCheck>' is disabled or deleted. Enable check(s) and try again with 'liquibase checks run --checkname='ChainedChecksTemplate1'

Ensure your checks are enabled to avoid this message.

Check execution

A check within a check chain will not execute separately outside the chain as a standalone check or show on its own in the console output.

You can only trigger a check separately that is within a chain by specifying the check in liquibase checks run --check-name=mycheck.

Check scope

Some checks are only applicable to the changelog or the database. It is best practice to separate each check chain by changelog or database checks. Otherwise you will receive a message that states:

Database checks skipped due to non-applicable object(s) for this check: Chained check template (Short names: ExampleCheck) skipped for: amount:column, uc_name:uniqueConstraint, supplier_name:column (See 12 more objects by setting command argument --verbose)

Syntax errors

If you types any operator incorrectly while setting the logic of your check chain, Liquibase displays the following error message:

Invalid value: 'checkname1 & checkname2': The supplied value is not valid. Enter the shortname, logic conditional (using &&, ||, !), and optional (groupings) for your checks. Example: "(shortname1 && shortname2) || shortname3":

If you see this error message, ensure that your operators are either &&, ||, or !.