Reference
Version · 6.0
Change Automation Reference

dropTable

Last updated: August 12, 2026

Drops an existing table from your database.

Run dropTable

To run this Change Type, follow these steps:

Add the Change Type to your changeset, as shown in the examples on this page.
Specify any required attributes. Use the table on this page to see which ones your database requires.
Deploy your changeset by running the update command:liquibase update

Available attributes

Name	Description	Required for	Supports	Since
`cascadeConstraints`	Boolean. Adds the `CASCADE CONSTRAINTS` SQL to the statement		all
`catalogName`	Name of the catalog		all	3.0
`schemaName`	Name of the schema		all
`tableName`	Name of the table to drop	all	all

Database support

Database	Notes	Auto Rollback
DB2/LUW	Supported	No
DB2/z	Supported	No
Derby	Supported	No
Firebird	Supported	No
Google BigQuery	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
Snowflake	Supported	No
SQL Server	Supported	No
SQLite	Supported	No
Sybase	Supported	No
Sybase Anywhere	Supported	No

dropTable examples

--liquibase formatted sql

--changeset liquibase-docs:dropTable-example
DROP  TABLE  cat.person;

databaseChangeLog:
-  changeSet:
    id:  dropTable-example
    author:  liquibase-docs
    changes:
    -  dropTable:
        cascadeConstraints:  true
        catalogName:  cat
        schemaName:  public
        tableName:  person

{
    "databaseChangeLog": [
        {
            "changeSet": {
                "id": "dropTable-example",
                "author": "liquibase-docs",
                "changes": [
                    {
                        "dropTable": {
                            "cascadeConstraints": true,
                            "catalogName": "cat",
                            "schemaName": "public",
                            "tableName": "person"
                        }
                    }
                ]
            }
        }
    ]
}

<databaseChangeLog
    xmlns="http://www.liquibase.org/xml/ns/dbchangelog"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:ext="http://www.liquibase.org/xml/ns/dbchangelog-ext"
    xmlns:pro="http://www.liquibase.org/xml/ns/pro"
    xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog
        http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-latest.xsd
        http://www.liquibase.org/xml/ns/dbchangelog-ext
        http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-ext.xsd
        http://www.liquibase.org/xml/ns/pro
        http://www.liquibase.org/xml/ns/pro/liquibase-pro-latest.xsd">

    <changeSet  author="liquibase-docs"  id="dropTable-example">
        <dropTable  cascadeConstraints="true"
            catalogName="cat"
            schemaName="public"
            tableName="person"/>
    </changeSet>

</databaseChangeLog>

--liquibase formatted sql

--changeset liquibase-docs:dropTable-example
DROP  TABLE  cat.person;

databaseChangeLog:
-  changeSet:
    id:  dropTable-example
    author:  liquibase-docs
    changes:
    -  dropTable:
        cascadeConstraints:  true
        catalogName:  cat
        schemaName:  public
        tableName:  person

{
    "databaseChangeLog": [
        {
            "changeSet": {
                "id": "dropTable-example",
                "author": "liquibase-docs",
                "changes": [
                    {
                        "dropTable": {
                            "cascadeConstraints": true,
                            "catalogName": "cat",
                            "schemaName": "public",
                            "tableName": "person"
                        }
                    }
                ]
            }
        }
    ]
}

<databaseChangeLog
    xmlns="http://www.liquibase.org/xml/ns/dbchangelog"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:ext="http://www.liquibase.org/xml/ns/dbchangelog-ext"
    xmlns:pro="http://www.liquibase.org/xml/ns/pro"
    xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog
        http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-latest.xsd
        http://www.liquibase.org/xml/ns/dbchangelog-ext
        http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-ext.xsd
        http://www.liquibase.org/xml/ns/pro
        http://www.liquibase.org/xml/ns/pro/liquibase-pro-latest.xsd">

    <changeSet  author="liquibase-docs"  id="dropTable-example">
        <dropTable  cascadeConstraints="true"
            catalogName="cat"
            schemaName="public"
            tableName="person"/>
    </changeSet>

</databaseChangeLog>

PreviousDropSynonym NextDropTrigger

dropTable

Run dropTable

Available attributes

Database support

dropTable examples

SQL example

YAML example

JSON example

XML example