varcharMaxSize

varcharMaxSize is a custom policy check that ensures all VARCHAR columns are under a maximum size.

This example works for relational databases. You can use this check as it is or customize it further to fit your needs in your SQL database.

Scope Database
Database Relational

Step-by-step

These steps describe how to create the Custom Policy Check. It does not exist by default in Liquibase Pro.

  1. Create a Check Settings file: Use the Checks Settings Configuration File
  2. Add this code to your Checks Settings file:

    Copy
    varcharMaxSize Quotes Python Script
    ###
    ### This script ensures all VARCHAR columns are under a maximum size
    ###
    ### Notes:

    ###
    ### Helpers come from Liquibase
    ###
    import sys
    import liquibase_utilities

    ###
    ### Retrieve log handler
    ### Ex. liquibase_logger.info(message)
    ###
    liquibase_logger = liquibase_utilities.get_logger()

    ###
    ### Retrieve status handler
    ###
    liquibase_status = liquibase_utilities.get_status()

    ###
    ### Retrive maximum size from check definition
    ###
    max_size = int(liquibase_utilities.get_arg("VARCHAR_MAX"))

    ###
    ### Retrieve database object
    ###
    database_object = liquibase_utilities.get_database_object()

    ###
    ### Skip if not a varchar column
    ###
    if "column" in database_object.getObjectTypeName().lower() and "varchar" in str(database_object.getType()).lower():
        column_name = database_object.getName()
        column_size = int(database_object.getType().getColumnSize())
        if column_size > max_size:
            liquibase_status.fired = True
            status_message = str(liquibase_utilities.get_script_message()).replace("__COLUMN_NAME__", f"'{column_name}'")
            status_message = status_message.replace("__COLUMN_SIZE__", f"{max_size}")
            liquibase_status.message = status_message
            sys.exit(1)

    ###
    ### Default return code
    ###
    False
  3. Initiate the customization process. In the CLI, run this command:
    liquibase checks customize --check-name=CustomCheckTemplate
    The CLI prompts you to finish configuring your file. A message displays:

    This check cannot be customized directly because one or more fields does not have a default value.

    Liquibase will then create a copy of CustomCheckTemplate and initiate the customization workflow.

  4. Give your check a short name so you can easily identify what Python script it is associated with (up to 64 alpha-numeric characters only).
    In this example we will name the check:
    varcharMaxSize

  5. Set the Severity to return a code of 0-4 when triggered. These severity codes allow you to determine if the job moves forward or stops when this check triggers.
    Learn more here: Use Policy Checks in Automation: Severity and Exit Code
    options: 'INFO'=0, 'MINOR'=1, 'MAJOR'=2, 'CRITICAL'=3, 'BLOCKER'=4

  6. Set SCRIPT_DESCRIPTION. In this example, we will set the description to:
    This script ensures all VARCHAR columns do not exceed VARCHAR_MAX size.
    • Set SCRIPT_SCOPE. In this example, we will set the scope to database.
  7. database: for example, if your check looks for the presence of keys, indexes, or table name patterns in your database schema (including Liquibase Tracking Tables). With this value, the check runs once for each database object.
  8. Set the SCRIPT_MESSAGE. This message will display when the check is triggered. In this example we will use:
    This script identified that Column __COLUMN_NAME__ exceeds __COLUMN_SIZE__.
  9. Set the SCRIPT_PATH. This is the relative path where your script is stored in relation to the changelog specified in --changelog-file, whether it is stored locally or in a repository.
    In this example, we will set the path to: scripts/varchar-max-size.py.
  10. Set the SCRIPT_ARGUMENT. This allows you to pass dynamic information into the Custom Policy Check without modifying the Python code. This is important so you do not hard code values into your check that may change over time or if you have different teams with different thresholds.

    In this example, specify VARCHAR_MAX=255 in the CLI to specify that the character max is 255.

    If you customize your check later, you can specify a new value in the CLI. If you don't need dynamic arguments, leave this field blank.
  11. Set the REQUIRES_SNAPSHOT. If your script scope is changelog, set whether the check requires a database snapshot. Specify true if your check needs to inspect database objects. (If your script scope is database, Liquibase always takes a snapshot, so this prompt does not appear.)
  12. Note: The larger your database, the more performance impact a snapshot causes. If you cannot run a snapshot due to memory limitations, see Memory Limits of Inspecting Large Schemas.

You have now successfully created and customized a policy check!

Next steps

Related Topics