dynamodb-waiters-log-notification-interval

--dynamodb-waiters-log-notification-interval is a global Boolean parameter for the Liquibase DynamoDB extension. It specifies the interval in milliseconds for Liquibase to wait between sending status notifications while the DynamoDbWaiter polls resources in your database. The default value is 3000.

Uses

When you ask Amazon DynamoDB to run an operation on a resource in your database, such as creating, updating, or deleting a table, DynamoDB calls a waiter class first. Waiters are AWS SDK objects that ensure consistency in distributed systems when DynamoDB doesn't perform operations instantly, but some code needs to wait until those operations are fully completed.

The waiter repeatedly checks whether the table is in the correct state (it "polls" the table). If the table is in the correct state (ACTIVE or non-existent), the waiter approves the operation. Otherwise, if the table status is CREATING, UPDATING, or DELETING, it tries polling again. The waiter repeats this indefinitely or until it times out. For more information, see Poll for resource states in the AWS SDK for Java 2.x: Waiters.

Note: Liquibase does not use Amazon DynamoDB waiters when you create, update, or delete indexes.

When you run Liquibase commands like update and rollback, Liquibase runs your changesets sequentially. For every change, it waits a default amount of time for DynamoDB to respond before moving onto the next changeset. The default waiter settings are appropriate for most situations. However, some operations may require custom waiter values to avoid errors or keep your CI/CD pipeline efficient.

You can customize the following behavior with Liquibase waiter parameters:

• Enabled: whether the waiter makes any polling attempts
• Interval: how long to wait between polling attempts
• Attempts: how many times to attempt to poll the resource
• Timeout: the total amount of time to spend polling
• Exit code: whether Liquibase fails after a waiter timeout
• Logs: whether Liquibase tells you about the status of the waiter, and how often to do so

The --dynamodb-waiters-log-notification-interval parameter controls the interval between Liquibase log notifications about the status of the DynamoDB waiter while the waiter polls pending resources:

• If you want more frequent log notifications, set a lower value (shorter interval).
• If you want less frequent log notifications, set a higher value (longer interval).

To control whether these notifications are enabled or disabled, see --dynamodb-waiters-log-notification-enabled.

Syntax

You can set this parameter in the following ways:

liquibase.dynamodb.waiters.log.notification.interval: <int>

stages:
  Default:
    actions:
      - type: liquibase
        command: update
        globalArgs: { dynamodb-waiters-log-notification-interval: "<int>" }

liquibase
 --dynamodb-waiters-log-notification-interval=<int> update
 --changelog-file=example-changelog.xml

JAVA_OPTS=-Dliquibase.dynamodb.waiters.log.notification.interval=<int>

LIQUIBASE_DYNAMODB_WAITERS_LOG_NOTIFICATION_INTERVAL=<int>

For more information, see Working with Command Parameters.