renameView

Renames an existing view.

Note: Liquibase supports views, but does not support materialized views.

Run renameView

To run this Change Type, follow these steps:

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

Available attributes

Name Description Required for Supports Since
catalogName

Name of the catalog

 all 3.0
newViewName New name for the view all all
oldViewName Existing name of the view to rename all all
schemaName

Name of the schema

 ingres, mariadb, mssql, mysql, postgresql, sqlite, sybase

Examples

--liquibase formatted sql

--changeset liquibase-docs:renameView-example
RENAME  TABLE  cat.v_person  TO  cat.v_person;
databaseChangeLog:
-  changeSet:
    id:  renameView-example
    author:  liquibase-docs
    changes:
    -  renameView:
        catalogName:  cat
        newViewName:  v_person
        oldViewName:  v_person
        schemaName:  public
{
    "databaseChangeLog": [
        {
            "changeSet": {
                "id": "renameView-example",
                "author": "liquibase-docs",
                "changes": [
                    {
                        "renameView": {
                            "catalogName": "cat",
                            "newViewName": "v_person",
                            "oldViewName": "v_person",
                            "schemaName": "public"
                        }
                    }
                ]
            }
        }
    ]
}
<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="renameView-example">
        <renameView  catalogName="cat"
            newViewName="v_person"
            oldViewName="v_person"
            schemaName="public"/>
    </changeSet>

</databaseChangeLog>

Database support

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