liquibase.change.core.AddUniqueConstraintChange Maven / Gradle / Ivy
package liquibase.change.core;
import liquibase.change.*;
import liquibase.database.Database;
import liquibase.snapshot.SnapshotGeneratorFactory;
import liquibase.statement.SqlStatement;
import liquibase.statement.core.AddUniqueConstraintStatement;
import liquibase.structure.core.Column;
import liquibase.structure.core.UniqueConstraint;
/**
* Adds a unique constraint to an existing column.
*/
@DatabaseChange(name="addUniqueConstraint", description = "Adds a unique constrant to an existing column or set of columns.", priority = ChangeMetaData.PRIORITY_DEFAULT, appliesTo = "column")
public class AddUniqueConstraintChange extends AbstractChange {
private String catalogName;
private String schemaName;
private String tableName;
private String columnNames;
private String constraintName;
private String tablespace;
private Boolean clustered;
private Boolean shouldValidate;
private String forIndexName;
private String forIndexSchemaName;
private String forIndexCatalogName;
private Boolean deferrable;
private Boolean initiallyDeferred;
private Boolean disabled;
@DatabaseChangeProperty(mustEqualExisting ="column.relation.catalog", since = "3.0")
public String getCatalogName() {
return catalogName;
}
public void setCatalogName(String catalogName) {
this.catalogName = catalogName;
}
@DatabaseChangeProperty(mustEqualExisting ="column.relation.schema")
public String getSchemaName() {
return schemaName;
}
public void setSchemaName(String schemaName) {
this.schemaName = schemaName;
}
@DatabaseChangeProperty(mustEqualExisting = "column.relation",
description = "Name of the table to create the unique constraint on")
public String getTableName() {
return tableName;
}
public void setTableName(String tableName) {
this.tableName = tableName;
}
@DatabaseChangeProperty(mustEqualExisting = "column", description =
"Name of the column(s) to create the unique constraint on. Comma separated if multiple")
public String getColumnNames() {
return columnNames;
}
public void setColumnNames(String columnNames) {
this.columnNames = columnNames;
}
@DatabaseChangeProperty(description = "Name of the unique constraint")
public String getConstraintName() {
return constraintName;
}
public void setConstraintName(String constraintName) {
this.constraintName = constraintName;
}
@DatabaseChangeProperty(description = "'Tablespace' to create the index in. Corresponds to file group in mssql")
public String getTablespace() {
return tablespace;
}
public void setTablespace(String tablespace) {
this.tablespace = tablespace;
}
@DatabaseChangeProperty(description = "True if this constraint is deferrable, False otherwise")
public Boolean getDeferrable() {
return deferrable;
}
public void setDeferrable(Boolean deferrable) {
this.deferrable = deferrable;
}
@DatabaseChangeProperty(description = "True if this constraint is initially deferred, False otherwise")
public Boolean getInitiallyDeferred() {
return initiallyDeferred;
}
public void setInitiallyDeferred(Boolean initiallyDeferred) {
this.initiallyDeferred = initiallyDeferred;
}
@DatabaseChangeProperty(description = "True if this constraint is disabled, False otherwise")
public Boolean getDisabled() {
return disabled;
}
public void setDisabled(Boolean disabled) {
this.disabled = disabled;
}
/**
* In Oracle PL/SQL, the VALIDATE keyword defines whether a newly added unique constraint on a
* column in a table should cause existing rows to be checked to see if they satisfy the
* uniqueness constraint or not.
* @return true if ENABLE VALIDATE (this is the default), or false if ENABLE NOVALIDATE.
*/
@DatabaseChangeProperty(description = "This is true if the unique constraint has 'ENABLE VALIDATE' set, or false if the foreign key has 'ENABLE NOVALIDATE' set.")
public Boolean getValidate() {
return shouldValidate;
}
/**
* @param validate - if shouldValidate is set to FALSE then the constraint will be created
* with the 'ENABLE NOVALIDATE' mode. This means the constraint would be created, but that no
* check will be done to ensure old data has valid constraints - only new data would be checked
* to see if it complies with the constraint logic. The default state for unique constraints is to
* have 'ENABLE VALIDATE' set.
*/
public void setValidate(Boolean validate) {
this.shouldValidate = validate;
}
public Boolean getClustered() {
return clustered;
}
public void setClustered(Boolean clustered) {
this.clustered = clustered;
}
public String getForIndexName() {
return forIndexName;
}
public void setForIndexName(String forIndexName) {
this.forIndexName = forIndexName;
}
public String getForIndexSchemaName() {
return forIndexSchemaName;
}
public void setForIndexSchemaName(String forIndexSchemaName) {
this.forIndexSchemaName = forIndexSchemaName;
}
public String getForIndexCatalogName() {
return forIndexCatalogName;
}
public void setForIndexCatalogName(String forIndexCatalogName) {
this.forIndexCatalogName = forIndexCatalogName;
}
@Override
public SqlStatement[] generateStatements(Database database) {
boolean deferrable = false;
if (getDeferrable() != null) {
deferrable = getDeferrable();
}
boolean initiallyDeferred = false;
if (getInitiallyDeferred() != null) {
initiallyDeferred = getInitiallyDeferred();
}
boolean disabled = false;
if (getDisabled() != null) {
disabled = getDisabled();
}
boolean clustered = false;
if (getClustered() != null) {
clustered = getClustered();
}
boolean shouldValidate = true;
if (getValidate() != null) {
shouldValidate = getValidate();
}
AddUniqueConstraintStatement statement = createAddUniqueConstraintStatement();
statement.setTablespace(getTablespace())
.setDeferrable(deferrable)
.setInitiallyDeferred(initiallyDeferred)
.setDisabled(disabled)
.setClustered(clustered)
.setShouldValidate(shouldValidate);
statement.setForIndexName(getForIndexName());
statement.setForIndexSchemaName(getForIndexSchemaName());
statement.setForIndexCatalogName(getForIndexCatalogName());
return new SqlStatement[] { statement };
}
protected AddUniqueConstraintStatement createAddUniqueConstraintStatement() {
return new AddUniqueConstraintStatement(getCatalogName(), getSchemaName(), getTableName(),
ColumnConfig.arrayFromNames(getColumnNames()), getConstraintName());
}
@Override
public ChangeStatus checkStatus(Database database) {
ChangeStatus result = new ChangeStatus();
try {
UniqueConstraint example = new UniqueConstraint(getConstraintName(), getCatalogName(), getSchemaName(),
getTableName(), Column.arrayFromNames(getColumnNames()));
UniqueConstraint snapshot = SnapshotGeneratorFactory.getInstance().createSnapshot(example, database);
result.assertComplete(snapshot != null, "Unique constraint does not exist");
return result;
} catch (Exception e) {
return result.unknown(e);
}
}
@Override
public String getConfirmationMessage() {
return "Unique constraint added to "+getTableName()+"("+getColumnNames()+")";
}
@Override
protected Change[] createInverses() {
DropUniqueConstraintChange inverse = new DropUniqueConstraintChange();
inverse.setSchemaName(getSchemaName());
inverse.setTableName(getTableName());
inverse.setConstraintName(getConstraintName());
inverse.setUniqueColumns(getColumnNames());
return new Change[]{
inverse,
};
}
@Override
public String getSerializedObjectNamespace() {
return STANDARD_CHANGELOG_NAMESPACE;
}
}