reports-drift-max-detailed-objects
Last updated: June 9, 2026
Sets the maximum number of changed objects that trigger the full detailed format in the drift report. When the number of changes exceeds this threshold, Liquibase uses a memory-efficient report format that preserves summaries and object listings but skips the most memory-intensive sections. Default: 10000.
In Liquibase Secure 5.2 and later, drift report generation includes two improvements for large databases:
Smart report mode — If your database has more than 10,000 changed objects (by default), the report skips the most memory-intensive sections but keeps summaries and object listings. You can adjust this limit if needed.
Faster processing — Report generation is faster and more memory-efficient for smaller databases.
For most users, this works automatically with no configuration required.
If you are still experiencing OutOfMemoryError exceptions, lower the threshold to trigger the optimized format sooner. Add the following to your liquibase.properties file:
liquibase.reports.drift.maxDetailedObjects=5000
This tells Liquibase to use the lightweight report format when there are more than 5,000 changes (instead of waiting until 10,000).
Learn more about heap memory here: What are the memory limits on inspecting large schema?
If you need full detailed reports for large snapshots, increase the threshold. Make sure you have sufficient heap memory available:
liquibase.reports.drift.maxDetailedObjects=50000
Syntax
You can set this property in the following ways:
Option | Syntax |
CLI parameter |
|
Liquibase properties file (defaults file) |
|
Flow file global argument (example) |
|
JVM system property (JAVA_OPTS environment variable) |
|
Liquibase environment variable |
|