Use search-path to locate changelogs on Azure

Last updated: July 14, 2025

Both a directory in the search path and a relative path are required to find changelog files or snapshot files. Follow the steps below to learn how to set both of these and configure them.

Procedure

1

Determine the paths necessary to locate the changelog to use.

If changelog resources, such as additional included changelogs or SQL files are in a different path, you will have multiple items in the searchpath.

If a changelog file is in Azure Blob Storage at az://myContainer/demo and the SQL files referenced by the changelog are in az://myContainer/demo/sqlFiles, your search path is az://myContainer/demo,az://myContainer/demo/sqlFiles.

2

Provide the searchpath and a filename or relative path to the changelogfile in remote storage.

Example 1: update-sql command using a changelog file in remote storage:

liquibase --search-path=az://myContainer/demo,az://myContainer/demo/sqlFiles update-sql --changelog-file=example-changelog.sql liquibase --search-path=az://myContainer/demo update-sql --changelog-file=example-changelog.sql

Example 2: update-sql command using a relative path to the changelog file in remote storage:

If the changelog is located in a subdirectory like az://myContainer/demo/changelogs, when you use the searchpath defined in the previous example, then you must specify the relative path to the changelog:

liquibase --search-path=az://myContainer/demo,az://myContainer/demo/sqlFiles update-sql --changelog-file=changelogs/example-changelog.sql

Note: Paths to changelogs must always be relative to preserve integrity of the Liquibase DATABASECHANGELOG tracking table.