Creates a lookup table containing values stored in a column and creates a foreign key to the new table.
| Name | Description | Required For | Supports | Since |
|---|---|---|---|---|
| constraintName | Name of the foreign-key constraint to create between the existing table and the lookup table | all | ||
| existingColumnName | Name of the column containing the data to extract | all | all | |
| existingTableCatalogName | all | |||
| existingTableName | Name of the table containing the data to extract | all | all | |
| existingTableSchemaName | all | |||
| newColumnDataType | Data type of the new table column | informix, mssql, h2, mysql | all | |
| newColumnName | Name of the column in the new table to create | all | all | |
| newTableCatalogName | all | 3.0 | ||
| newTableName | Name of lookup table to create | all | all | |
| newTableSchemaName | all |
<changeSet author="liquibase-docs" id="addLookupTable-example">
<addLookupTable constraintName="fk_address_state"
existingColumnName="state"
existingTableName="address"
newColumnDataType="char(2)"
newColumnName="abbreviation"
newTableName="state"/>
</changeSet>changeSet:
id: addLookupTable-example
author: liquibase-docs
changes:
- addLookupTable:
constraintName: fk_address_state
existingColumnName: state
existingTableName: address
newColumnDataType: char(2)
newColumnName: abbreviation
newTableName: state{
"changeSet": {
"id": "addLookupTable-example",
"author": "liquibase-docs",
"changes": [
{
"addLookupTable": {
"constraintName": "fk_address_state",
"existingColumnName": "state",
"existingTableName": "address",
"newColumnDataType": "char(2)",
"newColumnName": "abbreviation",
"newTableName": "state"
}
}]
}
}CREATE TABLE state AS SELECT DISTINCT state AS abbreviation FROM address WHERE state IS NOT NULL;
ALTER TABLE state MODIFY abbreviation CHAR(2) NOT NULL;
ALTER TABLE state ADD PRIMARY KEY (abbreviation);
ALTER TABLE address ADD CONSTRAINT fk_address_state FOREIGN KEY (state) REFERENCES state (abbreviation);| Database | Notes | Auto Rollback |
|---|---|---|
| DB2 | Supported | Yes |
| Derby | Supported | Yes |
| Firebird | Not Supported | Yes |
| H2 | Supported | Yes |
| HyperSQL | Supported | Yes |
| Informix | Supported | Yes |
| MySQL | Supported | Yes |
| Oracle | Supported | Yes |
| PostgreSQL | Supported | Yes |
| SQL Server | Supported | Yes |
| SQLite | Not Supported | Yes |
| Sybase | Supported | Yes |
| Sybase Anywhere | Supported | Yes |