Change: ‘dropColumn’

Drop existing column(s).

To drop a single column, use the simple form of this element where the tableName and columnName are specified as attributes. To drop several columns, specify the tableName as an attribute, and then specify a set of nested <column> tags. If nested <column> tags are present, the columnName attribute will be ignored.

Available Attributes

Name	Description
catalogName	Name of the catalog@ v3.0E.g. 'cat'
columnName	Name of the column to drop, if dropping a single column. Ignored if nested 'column's are definedE.g. 'id'
schemaName	Name of the schemaE.g. 'public'
tableName	Name of the table containing the column(s) to dropE.g. 'person'

Nested Properties

Name

Description

columns / column ^[0..N]

Columns to be dropped if dropping multiple columns. If this is populated, the columnName attribute is ignored.Note: columns tag not required in XML

name	Name of the column shall be dropped.

XML Sample
YAML Sample
JSON Sample

<changeSet author="liquibase-docs" id="dropColumn-example">
    <dropColumn catalogName="cat"
            columnName="id"
            schemaName="public"
            tableName="person">
        <column name="address"/>
    </dropColumn>
</changeSet>

changeSet:
  id: dropColumn-example
  author: liquibase-docs
  changes:
  - dropColumn:
      catalogName: cat
      columnName: id
      columns:
      - column:
          name: address
      schemaName: public
      tableName: person

{
  "changeSet": {
    "id": "dropColumn-example",
    "author": "liquibase-docs",
    "changes": [
      {
        "dropColumn": {
          "catalogName": "cat",
          "columnName": "id",
          "columns": [
            {
              "column": {
                "name": "address"
              }
            }]
          ,
          "schemaName": "public",
          "tableName": "person"
        }
      }]
    
  }
}

SQL Generated From Above Sample (MySQL)

ALTER TABLE cat.person DROP COLUMN address;

Database Support

Database	Notes	Auto Rollback
DB2/LUW	Supported	No
DB2/z	Not Supported	No
Derby	Supported	No
Firebird	Supported	No
H2	Supported	No
HyperSQL	Supported	No
INGRES	Supported	No
Informix	Supported	No
MariaDB	Supported	No
MySQL	Supported	No
Oracle	Supported	No
PostgreSQL	Supported	No
SQL Server	Supported	No
SQLite	Supported	No
Sybase	Supported	No
Sybase Anywhere	Supported	No

Liquibase Pro Changes

Liquibase Changes

Subscribe for email updates

- and/or -

Change: ‘dropColumn’

Available Attributes

Nested Properties

SQL Generated From Above Sample (MySQL)

Database Support