liquibase

Class Liquibase

java.lang.Object

liquibase.Liquibase

All Implemented Interfaces:

AutoCloseable

public class Liquibase
extends Object
implements AutoCloseable

Primary facade class for interacting with Liquibase. The built in command line, Ant, Maven and other ways of running Liquibase are wrappers around methods in this class.

Field Summary

Fields

Modifier and Type	Field and Description
protected Database	database
static String	MSG_COULD_NOT_RELEASE_LOCK

Constructor Summary

Constructors

Constructor and Description
Liquibase(DatabaseChangeLog changeLog, ResourceAccessor resourceAccessor, Database database)
Liquibase(String changeLogFile, ResourceAccessor resourceAccessor, Database database) Creates a Liquibase instance.
Liquibase(String changeLogFile, ResourceAccessor resourceAccessor, DatabaseConnection conn) Creates a Liquibase instance for a given DatabaseConnection.

Method Summary

Modifier and Type	Method and Description
protected ChangeLogIterator	buildChangeLogIterator(String tag, DatabaseChangeLog changeLog, Contexts contexts, LabelExpression labelExpression)
protected RawSQLChange	buildRawSQLChange(String rollbackScriptContents)
CheckSum	calculateCheckSum(String changeSetIdentifier) Deprecated. Use {link CommandScope(String).
CheckSum	calculateCheckSum(String filename, String id, String author) Deprecated. Use {link CommandScope(String).
void	changeLogSync(Contexts contexts) Deprecated. use version with LabelExpression
void	changeLogSync(Contexts contexts, LabelExpression labelExpression)
void	changeLogSync(Contexts contexts, LabelExpression labelExpression, Writer output)
void	changeLogSync(String contexts)
void	changeLogSync(String tag, Contexts contexts, LabelExpression labelExpression) Changelogsync or changelogsync to tag
void	changeLogSync(String tag, Contexts contexts, LabelExpression labelExpression, Writer output)
void	changeLogSync(String tag, String contexts)
void	changeLogSync(String tag, String contexts, Writer output)
void	changeLogSync(String contexts, Writer output)
void	checkLiquibaseTables(boolean updateExistingNullChecksums, DatabaseChangeLog databaseChangeLog, Contexts contexts, LabelExpression labelExpression)
void	clearCheckSums() Sets checksums to null so they will be repopulated next run
void	close()
protected RollbackVisitor	createRollbackVisitor()
protected RollbackVisitor	createRollbackVisitor(List<ChangesetsRolledback.ChangeSet> processedChangesets)
protected UpdateVisitor	createUpdateVisitor()
protected UpdateVisitor	createUpdateVisitor(ChangeExecListener listener)
DiffResult	diff(Database referenceDatabase, Database targetDatabase, CompareControl compareControl) Deprecated. Use {link CommandScope(String) to generate diff instead of this method.
void	dropAll() Drops all database objects in the default schema.
void	dropAll(CatalogAndSchema... schemas) Drops all database objects in the passed schema(s).
protected void	executeRollbackScript(String rollbackScript, List<ChangeSet> changeSets, Contexts contexts, LabelExpression labelExpression)
void	forceReleaseLocks()
void	futureRollbackSQL(Contexts contexts, LabelExpression labelExpression, Writer output)
void	futureRollbackSQL(Integer count, Contexts contexts, LabelExpression labelExpression, Writer output)
void	futureRollbackSQL(Integer count, Contexts contexts, LabelExpression labelExpression, Writer output, boolean checkLiquibaseTables)
protected void	futureRollbackSQL(Integer count, String tag, Contexts contexts, LabelExpression labelExpression, Writer output)
protected void	futureRollbackSQL(Integer count, String tag, Contexts contexts, LabelExpression labelExpression, Writer output, boolean checkLiquibaseTables)
void	futureRollbackSQL(Integer count, String contexts, Writer output)
void	futureRollbackSQL(Integer count, String contexts, Writer output, boolean checkLiquibaseTables)
void	futureRollbackSQL(String tag, Contexts contexts, LabelExpression labelExpression, Writer output)
void	futureRollbackSQL(String contexts, Writer output)
void	futureRollbackSQL(String contexts, Writer output, boolean checkLiquibaseTables)
void	futureRollbackSQL(Writer output)
void	generateChangeLog(CatalogAndSchema catalogAndSchema, DiffToChangeLog changeLogWriter, PrintStream outputStream, ChangeLogSerializer changeLogSerializer, Class<? extends DatabaseObject>... snapshotTypes) Deprecated. Use {link CommandScope(String) to generateChangelog instead of this method.
void	generateChangeLog(CatalogAndSchema catalogAndSchema, DiffToChangeLog changeLogWriter, PrintStream outputStream, Class<? extends DatabaseObject>... snapshotTypes) Deprecated. Use {link CommandScope(String) to generateChangelog instead of this method.
void	generateDocumentation(String outputDirectory)
void	generateDocumentation(String outputDirectory, Contexts contexts, LabelExpression labelExpression, CatalogAndSchema... schemaList)
void	generateDocumentation(String outputDirectory, String contexts)
void	generateDocumentation(String outputDirectory, String contexts, CatalogAndSchema... schemaList)
String	getChangeLogFile() Return the change log file used by this Liquibase instance.
ChangeLogParameters	getChangeLogParameters() Returns the ChangeLogParameters container used by this Liquibase instance.
List<ChangeSetStatus>	getChangeSetStatuses(Contexts contexts) Deprecated. use version with LabelExpression
List<ChangeSetStatus>	getChangeSetStatuses(Contexts contexts, LabelExpression labelExpression)
List<ChangeSetStatus>	getChangeSetStatuses(Contexts contexts, LabelExpression labelExpression, boolean checkLiquibaseTables) Returns the ChangeSetStatuses of all changesets in the change log file and history in the order they would be ran.
Connection	getConnection(DatabaseChangeLog changeLog) Create or retrieve the Connection object
Database	getDatabase() Returns the Database used by this Liquibase instance.
DatabaseChangeLog	getDatabaseChangeLog()
DefaultChangeExecListener	getDefaultChangeExecListener()
UUID	getHubConnectionId()
Logger	getLog() Return the log used by this Liquibase instance.
ResourceAccessor	getResourceAccessor() Return ResourceAccessor used by this Liquibase instance.
protected ChangeLogIterator	getStandardChangelogIterator(Contexts contexts, LabelExpression labelExpression, boolean collectAllReasons, DatabaseChangeLog changeLog) Return a ChangeLogIterator constructed with standard filters
protected ChangeLogIterator	getStandardChangelogIterator(Contexts contexts, LabelExpression labelExpression, DatabaseChangeLog changeLog)
boolean	isSafeToRunUpdate() Returns true if it is "save" to migrate the database.
protected boolean	isUpToDateFastCheck(Contexts contexts, LabelExpression labelExpression) Performs check of the historyService to determine if there is no unrun changesets without obtaining an exclusive write lock.
DatabaseChangeLogLock[]	listLocks() Display change log lock information.
Collection<RanChangeSet>	listUnexpectedChangeSets(Contexts contexts, LabelExpression labelExpression)
Collection<RanChangeSet>	listUnexpectedChangeSets(String contexts)
List<ChangeSet>	listUnrunChangeSets(Contexts contexts) Deprecated. use version with LabelExpression
List<ChangeSet>	listUnrunChangeSets(Contexts contexts, LabelExpression labels)
List<ChangeSet>	listUnrunChangeSets(Contexts contexts, LabelExpression labels, boolean checkLiquibaseTables)
void	markNextChangeSetRan(Contexts contexts, LabelExpression labelExpression)
void	markNextChangeSetRan(Contexts contexts, LabelExpression labelExpression, Writer output)
void	markNextChangeSetRan(String contexts)
void	markNextChangeSetRan(String contexts, Writer output)
void	outputHeader(String message)
protected void	removeRunStatus(List<ChangeSet> changeSets, Contexts contexts, LabelExpression labelExpression)
void	reportLocks(PrintStream out)
void	reportStatus(boolean verbose, Contexts contexts, LabelExpression labels, Writer out)
void	reportStatus(boolean verbose, Contexts contexts, Writer out)
void	reportStatus(boolean verbose, String contexts, Writer out)
void	reportUnexpectedChangeSets(boolean verbose, Contexts contexts, LabelExpression labelExpression, Writer out)
void	reportUnexpectedChangeSets(boolean verbose, String contexts, Writer out)
protected void	resetServices()
void	rollback(Date dateToRollBackTo, Contexts contexts, LabelExpression labelExpression)
void	rollback(Date dateToRollBackTo, Contexts contexts, LabelExpression labelExpression, Writer output)
void	rollback(Date dateToRollBackTo, String contexts)
void	rollback(Date dateToRollBackTo, String rollbackScript, Contexts contexts, LabelExpression labelExpression) Rollback to date
void	rollback(Date dateToRollBackTo, String rollbackScript, Contexts contexts, LabelExpression labelExpression, Writer output)
void	rollback(Date dateToRollBackTo, String rollbackScript, String contexts)
void	rollback(Date dateToRollBackTo, String rollbackScript, String contexts, Writer output)
void	rollback(Date dateToRollBackTo, String contexts, Writer output)
void	rollback(int changesToRollback, Contexts contexts, LabelExpression labelExpression)
void	rollback(int changesToRollback, Contexts contexts, LabelExpression labelExpression, Writer output)
void	rollback(int changesToRollback, Contexts contexts, Writer output)
void	rollback(int changesToRollback, String contexts)
void	rollback(int changesToRollback, String rollbackScript, Contexts contexts, LabelExpression labelExpression) Rollback count
void	rollback(int changesToRollback, String rollbackScript, Contexts contexts, LabelExpression labelExpression, Writer output)
void	rollback(int changesToRollback, String rollbackScript, Contexts contexts, Writer output)
void	rollback(int changesToRollback, String rollbackScript, String contexts)
void	rollback(int changesToRollback, String rollbackScript, String contexts, Writer output)
void	rollback(int changesToRollback, String contexts, Writer output)
void	rollback(String tagToRollBackTo, Contexts contexts)
void	rollback(String tagToRollBackTo, Contexts contexts, LabelExpression labelExpression)
void	rollback(String tagToRollBackTo, Contexts contexts, LabelExpression labelExpression, Writer output)
void	rollback(String tagToRollBackTo, Contexts contexts, Writer output)
void	rollback(String tagToRollBackTo, String contexts)
void	rollback(String tagToRollBackTo, String rollbackScript, Contexts contexts)
void	rollback(String tagToRollBackTo, String rollbackScript, Contexts contexts, LabelExpression labelExpression) Rollback to tag
void	rollback(String tagToRollBackTo, String rollbackScript, Contexts contexts, LabelExpression labelExpression, Writer output)
void	rollback(String tagToRollBackTo, String rollbackScript, Contexts contexts, Writer output)
void	rollback(String tagToRollBackTo, String rollbackScript, String contexts)
void	rollback(String tagToRollBackTo, String rollbackScript, String contexts, Writer output)
void	rollback(String tagToRollBackTo, String contexts, Writer output)
void	setChangeExecListener(ChangeExecListener listener)
void	setChangeLogParameter(String key, Object value)
void	setChangeLogSyncListener(ChangeLogSyncListener changeLogSyncListener)
void	setHubConnectionId(UUID hubConnectionId)
void	tag(String tagString) Deprecated. Use {link CommandScope(String) to tag instead of this method.
boolean	tagExists(String tagString) Deprecated. Use {link CommandScope(String) to verify tag exist instead of this method.
void	update() Convenience method for update(Contexts) that runs in "no context mode".
void	update(Contexts contexts) Executes Liquibase "update" logic which ensures that the configured Database is up to date according to the configured changelog file.
void	update(Contexts contexts, LabelExpression labelExpression) Liquibase update
void	update(Contexts contexts, LabelExpression labelExpression, boolean checkLiquibaseTables) Liquibase update
void	update(Contexts contexts, LabelExpression labelExpression, Writer output)
void	update(Contexts contexts, LabelExpression labelExpression, Writer output, boolean checkLiquibaseTables)
void	update(Contexts contexts, Writer output)
void	update(int changesToApply, Contexts contexts, LabelExpression labelExpression) Update to count
void	update(int changesToApply, Contexts contexts, LabelExpression labelExpression, Writer output)
void	update(int changesToApply, String contexts)
void	update(int changesToApply, String contexts, Writer output)
void	update(String contexts) Convenience method for update(Contexts) that constructs the Context object from the passed string.
void	update(String tag, Contexts contexts)
void	update(String tag, Contexts contexts, LabelExpression labelExpression) Update to tag
void	update(String tag, Contexts contexts, LabelExpression labelExpression, Writer output)
void	update(String tag, Contexts contexts, Writer output)
void	update(String tag, String contexts)
void	update(String tag, String contexts, Writer output)
void	update(String contexts, Writer output)
void	updateTestingRollback(Contexts contexts, LabelExpression labelExpression)
void	updateTestingRollback(String contexts)
void	updateTestingRollback(String tag, Contexts contexts, LabelExpression labelExpression)
void	validate() Checks changelogs for bad MD5Sums and preconditions before attempting a migration

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

MSG_COULD_NOT_RELEASE_LOCK

public static final String MSG_COULD_NOT_RELEASE_LOCK

database

protected Database database

Constructor Detail

Liquibase

public Liquibase(String changeLogFile,
                 ResourceAccessor resourceAccessor,
                 DatabaseConnection conn)
          throws LiquibaseException

Creates a Liquibase instance for a given DatabaseConnection. The Database instance used will be found with DatabaseFactory.findCorrectDatabaseImplementation(liquibase.database.DatabaseConnection)

Throws:

LiquibaseException

See Also:

DatabaseConnection, Database, Liquibase(String, liquibase.resource.ResourceAccessor, liquibase.database.Database), ResourceAccessor

Liquibase

public Liquibase(String changeLogFile,
                 ResourceAccessor resourceAccessor,
                 Database database)

Creates a Liquibase instance. The changeLogFile parameter must be a path that can be resolved by the passed ResourceAccessor. If windows style path separators are used for the changeLogFile, they will be standardized to unix style for better cross-system compatibility.

See Also:

DatabaseConnection, Database, ResourceAccessor

Liquibase

public Liquibase(DatabaseChangeLog changeLog,
                 ResourceAccessor resourceAccessor,
                 Database database)

Method Detail

getHubConnectionId

public UUID getHubConnectionId()

setHubConnectionId

public void setHubConnectionId(UUID hubConnectionId)

getChangeLogFile

public String getChangeLogFile()

Return the change log file used by this Liquibase instance.

getLog

public Logger getLog()

Return the log used by this Liquibase instance.

getChangeLogParameters

public ChangeLogParameters getChangeLogParameters()

Returns the ChangeLogParameters container used by this Liquibase instance.

getDatabase

public Database getDatabase()

Returns the Database used by this Liquibase instance.

getResourceAccessor

public ResourceAccessor getResourceAccessor()

Return ResourceAccessor used by this Liquibase instance.

update

public void update()
            throws LiquibaseException

Convenience method for update(Contexts) that runs in "no context mode".

Throws:

LiquibaseException

See Also:

contexts in documentation

update

public void update(String contexts)
            throws LiquibaseException

Convenience method for update(Contexts) that constructs the Context object from the passed string. To run in "no context mode", pass a null or empty "".

Throws:

LiquibaseException

See Also:

contexts in documentation

update

public void update(Contexts contexts)
            throws LiquibaseException

Executes Liquibase "update" logic which ensures that the configured Database is up to date according to the configured changelog file. To run in "no context mode", pass a null or empty context object.

Throws:

LiquibaseException

See Also:

contexts in documentation

update

public void update(Contexts contexts,
                   LabelExpression labelExpression)
            throws LiquibaseException

Liquibase update

Parameters:

contexts -

labelExpression -

Throws:

LiquibaseException

See Also:

contexts in documentation, labels in documentation

update

public void update(Contexts contexts,
                   LabelExpression labelExpression,
                   boolean checkLiquibaseTables)
            throws LiquibaseException

Liquibase update

Parameters:

contexts -

labelExpression -

checkLiquibaseTables -

Throws:

LiquibaseException

See Also:

contexts in documentation, labels in documentation

isUpToDateFastCheck

protected boolean isUpToDateFastCheck(Contexts contexts,
                                      LabelExpression labelExpression)
                               throws LiquibaseException

Performs check of the historyService to determine if there is no unrun changesets without obtaining an exclusive write lock. This allows multiple peer services to boot in parallel in the common case where there are no changelogs to run.

If we see that there is nothing in the changelog to run and this returns true, then regardless of the lock status we already know we are "done" and can finish up without waiting for the lock.

But, if there are changelogs that might have to be ran and this returns false, you MUST get a lock and do a real check to know what changesets actually need to run.

NOTE: to reduce the number of queries to the databasehistory table, this method will cache the "fast check" results within this instance under the assumption that the total changesets will not change within this instance.

Throws:

LiquibaseException

getConnection

public Connection getConnection(DatabaseChangeLog changeLog)
                         throws LiquibaseHubException

Create or retrieve the Connection object

Parameters:

changeLog - Database changelog

Returns:

Connection

Throws:

LiquibaseHubException - Thrown by HubService

getDatabaseChangeLog

public DatabaseChangeLog getDatabaseChangeLog()
                                       throws LiquibaseException

Throws:

LiquibaseException

createUpdateVisitor

protected UpdateVisitor createUpdateVisitor()

createUpdateVisitor

protected UpdateVisitor createUpdateVisitor(ChangeExecListener listener)

createRollbackVisitor

protected RollbackVisitor createRollbackVisitor()

createRollbackVisitor

protected RollbackVisitor createRollbackVisitor(List<ChangesetsRolledback.ChangeSet> processedChangesets)

getStandardChangelogIterator

protected ChangeLogIterator getStandardChangelogIterator(Contexts contexts,
                                                         LabelExpression labelExpression,
                                                         DatabaseChangeLog changeLog)
                                                  throws DatabaseException

Throws:

DatabaseException

getStandardChangelogIterator

protected ChangeLogIterator getStandardChangelogIterator(Contexts contexts,
                                                         LabelExpression labelExpression,
                                                         boolean collectAllReasons,
                                                         DatabaseChangeLog changeLog)
                                                  throws DatabaseException

Return a ChangeLogIterator constructed with standard filters

Parameters:

contexts - Contexts to filter for

labelExpression - Labels to filter for

collectAllReasons - Flag to control whether all skip reasons are accumulated default value is false to only gather the first

changeLog - The changelog to process

Returns:

ChangeLogIterator

Throws:

DatabaseException

buildChangeLogIterator

protected ChangeLogIterator buildChangeLogIterator(String tag,
                                                   DatabaseChangeLog changeLog,
                                                   Contexts contexts,
                                                   LabelExpression labelExpression)
                                            throws DatabaseException

Throws:

DatabaseException

update

public void update(String contexts,
                   Writer output)
            throws LiquibaseException

Throws:

LiquibaseException

update

public void update(Contexts contexts,
                   Writer output)
            throws LiquibaseException

Throws:

LiquibaseException

update

public void update(Contexts contexts,
                   LabelExpression labelExpression,
                   Writer output)
            throws LiquibaseException

Throws:

LiquibaseException

update

public void update(Contexts contexts,
                   LabelExpression labelExpression,
                   Writer output,
                   boolean checkLiquibaseTables)
            throws LiquibaseException

Throws:

LiquibaseException

update

public void update(int changesToApply,
                   String contexts)
            throws LiquibaseException

Throws:

LiquibaseException

update

public void update(int changesToApply,
                   Contexts contexts,
                   LabelExpression labelExpression)
            throws LiquibaseException

Update to count

Parameters:

changesToApply -

contexts -

labelExpression -

Throws:

LiquibaseException

update

public void update(String tag,
                   String contexts)
            throws LiquibaseException

Throws:

LiquibaseException

update

public void update(String tag,
                   Contexts contexts)
            throws LiquibaseException

Throws:

LiquibaseException

update

public void update(String tag,
                   Contexts contexts,
                   LabelExpression labelExpression)
            throws LiquibaseException

Update to tag

Parameters:

tag - Tag to update for

contexts -

labelExpression -

Throws:

LiquibaseException

update

public void update(int changesToApply,
                   String contexts,
                   Writer output)
            throws LiquibaseException

Throws:

LiquibaseException

update

public void update(int changesToApply,
                   Contexts contexts,
                   LabelExpression labelExpression,
                   Writer output)
            throws LiquibaseException

Throws:

LiquibaseException

update

public void update(String tag,
                   String contexts,
                   Writer output)
            throws LiquibaseException

Throws:

LiquibaseException

update

public void update(String tag,
                   Contexts contexts,
                   Writer output)
            throws LiquibaseException

Throws:

LiquibaseException

update

public void update(String tag,
                   Contexts contexts,
                   LabelExpression labelExpression,
                   Writer output)
            throws LiquibaseException

Throws:

LiquibaseException

outputHeader

public void outputHeader(String message)
                  throws DatabaseException

Throws:

DatabaseException

rollback

public void rollback(int changesToRollback,
                     String contexts,
                     Writer output)
              throws LiquibaseException

Throws:

LiquibaseException

rollback

public void rollback(int changesToRollback,
                     Contexts contexts,
                     Writer output)
              throws LiquibaseException

Throws:

LiquibaseException

rollback

public void rollback(int changesToRollback,
                     Contexts contexts,
                     LabelExpression labelExpression,
                     Writer output)
              throws LiquibaseException

Throws:

LiquibaseException

rollback

public void rollback(int changesToRollback,
                     String rollbackScript,
                     String contexts,
                     Writer output)
              throws LiquibaseException

Throws:

LiquibaseException

rollback

public void rollback(int changesToRollback,
                     String rollbackScript,
                     Contexts contexts,
                     Writer output)
              throws LiquibaseException

Throws:

LiquibaseException

rollback

public void rollback(int changesToRollback,
                     String rollbackScript,
                     Contexts contexts,
                     LabelExpression labelExpression,
                     Writer output)
              throws LiquibaseException

Throws:

LiquibaseException

rollback

public void rollback(int changesToRollback,
                     String contexts)
              throws LiquibaseException

Throws:

LiquibaseException

rollback

public void rollback(int changesToRollback,
                     Contexts contexts,
                     LabelExpression labelExpression)
              throws LiquibaseException

Throws:

LiquibaseException

rollback

public void rollback(int changesToRollback,
                     String rollbackScript,
                     String contexts)
              throws LiquibaseException

Throws:

LiquibaseException

rollback

public void rollback(int changesToRollback,
                     String rollbackScript,
                     Contexts contexts,
                     LabelExpression labelExpression)
              throws LiquibaseException

Rollback count

Parameters:

changesToRollback -

rollbackScript -

contexts -

labelExpression -

Throws:

LiquibaseException

removeRunStatus

protected void removeRunStatus(List<ChangeSet> changeSets,
                               Contexts contexts,
                               LabelExpression labelExpression)
                        throws LiquibaseException

Throws:

LiquibaseException

executeRollbackScript

protected void executeRollbackScript(String rollbackScript,
                                     List<ChangeSet> changeSets,
                                     Contexts contexts,
                                     LabelExpression labelExpression)
                              throws LiquibaseException

Throws:

LiquibaseException

buildRawSQLChange

protected RawSQLChange buildRawSQLChange(String rollbackScriptContents)

rollback

public void rollback(String tagToRollBackTo,
                     String contexts,
                     Writer output)
              throws LiquibaseException

Throws:

LiquibaseException

rollback

public void rollback(String tagToRollBackTo,
                     Contexts contexts,
                     Writer output)
              throws LiquibaseException

Throws:

LiquibaseException

rollback

public void rollback(String tagToRollBackTo,
                     Contexts contexts,
                     LabelExpression labelExpression,
                     Writer output)
              throws LiquibaseException

Throws:

LiquibaseException

rollback

public void rollback(String tagToRollBackTo,
                     String rollbackScript,
                     String contexts,
                     Writer output)
              throws LiquibaseException

Throws:

LiquibaseException

rollback

public void rollback(String tagToRollBackTo,
                     String rollbackScript,
                     Contexts contexts,
                     Writer output)
              throws LiquibaseException

Throws:

LiquibaseException

rollback

public void rollback(String tagToRollBackTo,
                     String rollbackScript,
                     Contexts contexts,
                     LabelExpression labelExpression,
                     Writer output)
              throws LiquibaseException

Throws:

LiquibaseException

rollback

public void rollback(String tagToRollBackTo,
                     String contexts)
              throws LiquibaseException

Throws:

LiquibaseException

rollback

public void rollback(String tagToRollBackTo,
                     Contexts contexts)
              throws LiquibaseException

Throws:

LiquibaseException

rollback

public void rollback(String tagToRollBackTo,
                     Contexts contexts,
                     LabelExpression labelExpression)
              throws LiquibaseException

Throws:

LiquibaseException

rollback

public void rollback(String tagToRollBackTo,
                     String rollbackScript,
                     String contexts)
              throws LiquibaseException

Throws:

LiquibaseException

rollback

public void rollback(String tagToRollBackTo,
                     String rollbackScript,
                     Contexts contexts)
              throws LiquibaseException

Throws:

LiquibaseException

rollback

public void rollback(String tagToRollBackTo,
                     String rollbackScript,
                     Contexts contexts,
                     LabelExpression labelExpression)
              throws LiquibaseException

Rollback to tag

Parameters:

tagToRollBackTo -

rollbackScript -

contexts -

labelExpression -

Throws:

LiquibaseException

rollback

public void rollback(Date dateToRollBackTo,
                     String contexts,
                     Writer output)
              throws LiquibaseException

Throws:

LiquibaseException

rollback

public void rollback(Date dateToRollBackTo,
                     String rollbackScript,
                     String contexts,
                     Writer output)
              throws LiquibaseException

Throws:

LiquibaseException

rollback

public void rollback(Date dateToRollBackTo,
                     Contexts contexts,
                     LabelExpression labelExpression,
                     Writer output)
              throws LiquibaseException

Throws:

LiquibaseException

rollback

public void rollback(Date dateToRollBackTo,
                     String rollbackScript,
                     Contexts contexts,
                     LabelExpression labelExpression,
                     Writer output)
              throws LiquibaseException

Throws:

LiquibaseException

rollback

public void rollback(Date dateToRollBackTo,
                     String contexts)
              throws LiquibaseException

Throws:

LiquibaseException

rollback

public void rollback(Date dateToRollBackTo,
                     Contexts contexts,
                     LabelExpression labelExpression)
              throws LiquibaseException

Throws:

LiquibaseException

rollback

public void rollback(Date dateToRollBackTo,
                     String rollbackScript,
                     String contexts)
              throws LiquibaseException

Throws:

LiquibaseException

rollback

public void rollback(Date dateToRollBackTo,
                     String rollbackScript,
                     Contexts contexts,
                     LabelExpression labelExpression)
              throws LiquibaseException

Rollback to date

Parameters:

dateToRollBackTo -

rollbackScript -

contexts -

labelExpression -

Throws:

LiquibaseException

changeLogSync

public void changeLogSync(String contexts,
                          Writer output)
                   throws LiquibaseException

Throws:

LiquibaseException

changeLogSync

public void changeLogSync(Contexts contexts,
                          LabelExpression labelExpression,
                          Writer output)
                   throws LiquibaseException

Throws:

LiquibaseException

changeLogSync

public void changeLogSync(String contexts)
                   throws LiquibaseException

Throws:

LiquibaseException

changeLogSync

@Deprecated
public void changeLogSync(Contexts contexts)
                               throws LiquibaseException

Deprecated. use version with LabelExpression

Throws:

LiquibaseException

changeLogSync

public void changeLogSync(Contexts contexts,
                          LabelExpression labelExpression)
                   throws LiquibaseException

Throws:

LiquibaseException

changeLogSync

public void changeLogSync(String tag,
                          String contexts)
                   throws LiquibaseException

Throws:

LiquibaseException

changeLogSync

public void changeLogSync(String tag,
                          Contexts contexts,
                          LabelExpression labelExpression)
                   throws LiquibaseException

Changelogsync or changelogsync to tag

Parameters:

tag -

contexts -

labelExpression -

Throws:

LiquibaseException

changeLogSync

public void changeLogSync(String tag,
                          String contexts,
                          Writer output)
                   throws LiquibaseException

Throws:

LiquibaseException

changeLogSync

public void changeLogSync(String tag,
                          Contexts contexts,
                          LabelExpression labelExpression,
                          Writer output)
                   throws LiquibaseException

Throws:

LiquibaseException

markNextChangeSetRan

public void markNextChangeSetRan(String contexts,
                                 Writer output)
                          throws LiquibaseException

Throws:

LiquibaseException

markNextChangeSetRan

public void markNextChangeSetRan(Contexts contexts,
                                 LabelExpression labelExpression,
                                 Writer output)
                          throws LiquibaseException

Throws:

LiquibaseException

markNextChangeSetRan

public void markNextChangeSetRan(String contexts)
                          throws LiquibaseException

Throws:

LiquibaseException

markNextChangeSetRan

public void markNextChangeSetRan(Contexts contexts,
                                 LabelExpression labelExpression)
                          throws LiquibaseException

Throws:

LiquibaseException

futureRollbackSQL

public void futureRollbackSQL(String contexts,
                              Writer output)
                       throws LiquibaseException

Throws:

LiquibaseException

futureRollbackSQL

public void futureRollbackSQL(Writer output)
                       throws LiquibaseException

Throws:

LiquibaseException

futureRollbackSQL

public void futureRollbackSQL(String contexts,
                              Writer output,
                              boolean checkLiquibaseTables)
                       throws LiquibaseException

Throws:

LiquibaseException

futureRollbackSQL

public void futureRollbackSQL(Integer count,
                              String contexts,
                              Writer output)
                       throws LiquibaseException

Throws:

LiquibaseException

futureRollbackSQL

public void futureRollbackSQL(Contexts contexts,
                              LabelExpression labelExpression,
                              Writer output)
                       throws LiquibaseException

Throws:

LiquibaseException

futureRollbackSQL

public void futureRollbackSQL(Integer count,
                              String contexts,
                              Writer output,
                              boolean checkLiquibaseTables)
                       throws LiquibaseException

Throws:

LiquibaseException

futureRollbackSQL

public void futureRollbackSQL(Integer count,
                              Contexts contexts,
                              LabelExpression labelExpression,
                              Writer output)
                       throws LiquibaseException

Throws:

LiquibaseException

futureRollbackSQL

public void futureRollbackSQL(Integer count,
                              Contexts contexts,
                              LabelExpression labelExpression,
                              Writer output,
                              boolean checkLiquibaseTables)
                       throws LiquibaseException

Throws:

LiquibaseException

futureRollbackSQL

public void futureRollbackSQL(String tag,
                              Contexts contexts,
                              LabelExpression labelExpression,
                              Writer output)
                       throws LiquibaseException

Throws:

LiquibaseException

futureRollbackSQL

protected void futureRollbackSQL(Integer count,
                                 String tag,
                                 Contexts contexts,
                                 LabelExpression labelExpression,
                                 Writer output)
                          throws LiquibaseException

Throws:

LiquibaseException

futureRollbackSQL

protected void futureRollbackSQL(Integer count,
                                 String tag,
                                 Contexts contexts,
                                 LabelExpression labelExpression,
                                 Writer output,
                                 boolean checkLiquibaseTables)
                          throws LiquibaseException

Throws:

LiquibaseException

resetServices

protected void resetServices()

dropAll

public final void dropAll()
                   throws DatabaseException

Drops all database objects in the default schema.

Throws:

DatabaseException

dropAll

public final void dropAll(CatalogAndSchema... schemas)
                   throws DatabaseException

Drops all database objects in the passed schema(s).

Throws:

DatabaseException

tag

@Deprecated
public void tag(String tagString)
                     throws LiquibaseException

Deprecated. Use {link CommandScope(String) to tag instead of this method.

'Tags' the database for future rollback

Throws:

LiquibaseException

tagExists

@Deprecated
public boolean tagExists(String tagString)
                              throws LiquibaseException

Deprecated. Use {link CommandScope(String) to verify tag exist instead of this method.

Verifies if a given tag exist in the database

Throws:

LiquibaseException

updateTestingRollback

public void updateTestingRollback(String contexts)
                           throws LiquibaseException

Throws:

LiquibaseException

updateTestingRollback

public void updateTestingRollback(Contexts contexts,
                                  LabelExpression labelExpression)
                           throws LiquibaseException

Throws:

LiquibaseException

updateTestingRollback

public void updateTestingRollback(String tag,
                                  Contexts contexts,
                                  LabelExpression labelExpression)
                           throws LiquibaseException

Throws:

LiquibaseException

checkLiquibaseTables

public void checkLiquibaseTables(boolean updateExistingNullChecksums,
                                 DatabaseChangeLog databaseChangeLog,
                                 Contexts contexts,
                                 LabelExpression labelExpression)
                          throws LiquibaseException

Throws:

LiquibaseException

isSafeToRunUpdate

public boolean isSafeToRunUpdate()
                          throws DatabaseException

Returns true if it is "save" to migrate the database. Currently, "safe" is defined as running in an output-sql mode or against a database on localhost. It is fine to run Liquibase against a "non-safe" database, the method is mainly used to determine if the user should be prompted before continuing.

Throws:

DatabaseException

listLocks

public DatabaseChangeLogLock[] listLocks()
                                  throws LiquibaseException

Display change log lock information.

Throws:

LiquibaseException

reportLocks

public void reportLocks(PrintStream out)
                 throws LiquibaseException

Throws:

LiquibaseException

forceReleaseLocks

public void forceReleaseLocks()
                       throws LiquibaseException

Throws:

LiquibaseException

listUnrunChangeSets

@Deprecated
public List<ChangeSet> listUnrunChangeSets(Contexts contexts)
                                                throws LiquibaseException

Deprecated. use version with LabelExpression

Throws:

LiquibaseException

listUnrunChangeSets

public List<ChangeSet> listUnrunChangeSets(Contexts contexts,
                                           LabelExpression labels)
                                    throws LiquibaseException

Throws:

LiquibaseException

listUnrunChangeSets

public List<ChangeSet> listUnrunChangeSets(Contexts contexts,
                                           LabelExpression labels,
                                           boolean checkLiquibaseTables)
                                    throws LiquibaseException

Throws:

LiquibaseException

getChangeSetStatuses

@Deprecated
public List<ChangeSetStatus> getChangeSetStatuses(Contexts contexts)
                                                       throws LiquibaseException

Deprecated. use version with LabelExpression

Throws:

LiquibaseException

getChangeSetStatuses

public List<ChangeSetStatus> getChangeSetStatuses(Contexts contexts,
                                                  LabelExpression labelExpression)
                                           throws LiquibaseException

Throws:

LiquibaseException

getChangeSetStatuses

public List<ChangeSetStatus> getChangeSetStatuses(Contexts contexts,
                                                  LabelExpression labelExpression,
                                                  boolean checkLiquibaseTables)
                                           throws LiquibaseException

Returns the ChangeSetStatuses of all changesets in the change log file and history in the order they would be ran.

Throws:

LiquibaseException

reportStatus

public void reportStatus(boolean verbose,
                         String contexts,
                         Writer out)
                  throws LiquibaseException

Throws:

LiquibaseException

reportStatus

public void reportStatus(boolean verbose,
                         Contexts contexts,
                         Writer out)
                  throws LiquibaseException

Throws:

LiquibaseException

reportStatus

public void reportStatus(boolean verbose,
                         Contexts contexts,
                         LabelExpression labels,
                         Writer out)
                  throws LiquibaseException

Throws:

LiquibaseException

listUnexpectedChangeSets

public Collection<RanChangeSet> listUnexpectedChangeSets(String contexts)
                                                  throws LiquibaseException

Throws:

LiquibaseException

listUnexpectedChangeSets

public Collection<RanChangeSet> listUnexpectedChangeSets(Contexts contexts,
                                                         LabelExpression labelExpression)
                                                  throws LiquibaseException

Throws:

LiquibaseException

reportUnexpectedChangeSets

public void reportUnexpectedChangeSets(boolean verbose,
                                       String contexts,
                                       Writer out)
                                throws LiquibaseException

Throws:

LiquibaseException

reportUnexpectedChangeSets

public void reportUnexpectedChangeSets(boolean verbose,
                                       Contexts contexts,
                                       LabelExpression labelExpression,
                                       Writer out)
                                throws LiquibaseException

Throws:

LiquibaseException

clearCheckSums

public void clearCheckSums()
                    throws LiquibaseException

Sets checksums to null so they will be repopulated next run

Throws:

LiquibaseException

calculateCheckSum

@Deprecated
public final CheckSum calculateCheckSum(String changeSetIdentifier)
                                             throws LiquibaseException

Deprecated. Use {link CommandScope(String).

Calculate the checksum for a given identifier

Throws:

LiquibaseException

calculateCheckSum

@Deprecated
public CheckSum calculateCheckSum(String filename,
                                              String id,
                                              String author)
                                       throws LiquibaseException

Deprecated. Use {link CommandScope(String).

Calculates the checksum for the values that form a given identifier

Throws:

LiquibaseException

generateDocumentation

public void generateDocumentation(String outputDirectory)
                           throws LiquibaseException

Throws:

LiquibaseException

generateDocumentation

public void generateDocumentation(String outputDirectory,
                                  String contexts)
                           throws LiquibaseException

Throws:

LiquibaseException

generateDocumentation

public void generateDocumentation(String outputDirectory,
                                  String contexts,
                                  CatalogAndSchema... schemaList)
                           throws LiquibaseException

Throws:

LiquibaseException

generateDocumentation

public void generateDocumentation(String outputDirectory,
                                  Contexts contexts,
                                  LabelExpression labelExpression,
                                  CatalogAndSchema... schemaList)
                           throws LiquibaseException

Throws:

LiquibaseException

diff

@Deprecated
public DiffResult diff(Database referenceDatabase,
                                   Database targetDatabase,
                                   CompareControl compareControl)
                            throws LiquibaseException

Deprecated. Use {link CommandScope(String) to generate diff instead of this method.

Throws:

LiquibaseException

validate

public void validate()
              throws LiquibaseException

Checks changelogs for bad MD5Sums and preconditions before attempting a migration

Throws:

LiquibaseException

setChangeLogParameter

public void setChangeLogParameter(String key,
                                  Object value)

setChangeExecListener

public void setChangeExecListener(ChangeExecListener listener)

setChangeLogSyncListener

public void setChangeLogSyncListener(ChangeLogSyncListener changeLogSyncListener)

getDefaultChangeExecListener

public DefaultChangeExecListener getDefaultChangeExecListener()

generateChangeLog

@Deprecated
 @SafeVarargs
public final void generateChangeLog(CatalogAndSchema catalogAndSchema,
                                                              DiffToChangeLog changeLogWriter,
                                                              PrintStream outputStream,
                                                              Class<? extends DatabaseObject>... snapshotTypes)
                                                       throws DatabaseException,
                                                              IOException,
                                                              ParserConfigurationException,
                                                              CommandExecutionException

Deprecated. Use {link CommandScope(String) to generateChangelog instead of this method.

Throws:

DatabaseException

IOException

ParserConfigurationException

CommandExecutionException

generateChangeLog

@Deprecated
 @SafeVarargs
public final void generateChangeLog(CatalogAndSchema catalogAndSchema,
                                                              DiffToChangeLog changeLogWriter,
                                                              PrintStream outputStream,
                                                              ChangeLogSerializer changeLogSerializer,
                                                              Class<? extends DatabaseObject>... snapshotTypes)
                                                       throws DatabaseException,
                                                              IOException,
                                                              ParserConfigurationException,
                                                              CommandExecutionException

Deprecated. Use {link CommandScope(String) to generateChangelog instead of this method.

Throws:

DatabaseException

IOException

ParserConfigurationException

CommandExecutionException

close

public void close()
           throws LiquibaseException

Specified by:

close in interface AutoCloseable

Throws:

LiquibaseException