drop-public-synonyms
Last updated: October 28, 2025
--drop-public-synonyms is a Boolean parameter that controls whether Liquibase includes public synonyms in drop operations when comparing databases. The default value is true. This parameter is available in Liquibase Pro and Liquibase Secure and requires a valid license.
Uses
When you run database comparison commands like diff-changelog or drop-all, Liquibase identifies database objects that exist in the target database but not in the reference database. For synonyms, Liquibase handles private and public synonyms differently:
- Private synonyms are always included in drop operations, regardless of this parameter setting
- Public synonyms are included in drop operations by default (--drop-public-synonyms=true)
You may want to set --drop-public-synonyms to false in the following scenarios:
- Shared public synonyms: Your environment has enterprise-wide public synonyms that are managed separately and should not be modified during schema comparisons - Multi-application databases: Public synonyms are used by multiple applications or schemas, and dropping them would affect other systems - Selective synchronization: You want to synchronize schema-specific objects while preserving shared public synonyms
Keep the default value of true when you want complete database synchronization, including all synonym objects.
Note: This parameter applies to Oracle and SQL Server databases that support synonym objects.
Syntax
You can set this parameter in the following ways:
Option | Syntax |
Liquibase properties file (defaults file) |
|
Global flow file argument |
|
Global CLI parameter |
|
JVM system property(JAVA_OPTS environment variable) | Unix/Linux/Mac:
Windows:
|
Liquibase environment variable |
|
For more information, see Working with command parameters.
Change history
Version | Changes |
Liquibase Secure, version 5.0 | Parameter changed from - Here are the previous values from when it was - Liquibase properties file (defaults file) Global flow file argument
Global CLI parameter
JVM system property(JAVA_OPTS environment variable) Unix:
Windows:
|