PostgreSQL 9.4.1 Documentation
Prev | Up |  | Next

# ALTER MATERIALIZED VIEW

## Name

ALTER MATERIALIZED VIEW -- change the definition of a materialized view

## Synopsis

    ALTER MATERIALIZED VIEW [ IF EXISTS ] name
        action [, ... ]
    ALTER MATERIALIZED VIEW [ IF EXISTS ] name
        RENAME [ COLUMN ] column_name TO new_column_name
    ALTER MATERIALIZED VIEW [ IF EXISTS ] name
        RENAME TO new_name
    ALTER MATERIALIZED VIEW [ IF EXISTS ] name
        SET SCHEMA new_schema
    ALTER MATERIALIZED VIEW ALL IN TABLESPACE name [ OWNED BY role_name [, ... ] ]
        SET TABLESPACE new_tablespace [ NOWAIT ]

    where action is one of:

        ALTER [ COLUMN ] column_name SET STATISTICS integer
        ALTER [ COLUMN ] column_name SET ( attribute_option = value [, ... ] )
        ALTER [ COLUMN ] column_name RESET ( attribute_option [, ... ] )
        ALTER [ COLUMN ] column_name SET STORAGE { PLAIN | EXTERNAL | EXTENDED | MAIN }
        CLUSTER ON index_name
        SET WITHOUT CLUSTER
        SET ( storage_parameter = value [, ... ] )
        RESET ( storage_parameter [, ... ] )
        OWNER TO new_owner
        SET TABLESPACE new_tablespace

## Description

`ALTER MATERIALIZED VIEW` changes various auxiliary properties of an existing materialized view.

You must own the materialized view to use `ALTER MATERIALIZED VIEW`. To change a materialized view's schema, you must also have `CREATE` privilege on the new schema. To alter the owner, you must also be a direct or indirect member of the new owning role, and that role must have `CREATE` privilege on the materialized view's schema. (These restrictions enforce that altering the owner doesn't do anything you couldn't do by dropping and recreating the materialized view. However, a superuser can alter ownership of any view anyway.)

The statement subforms and actions available for `ALTER MATERIALIZED VIEW` are a subset of those available for `ALTER TABLE`, and have the same meaning when used for materialized views. See the descriptions for ALTER TABLE for details.

## Parameters

`name`

  The name (optionally schema-qualified) of an existing materialized view.

`column_name`

  Name of a new or existing column.

`new_column_name`

  New name for an existing column.

`new_owner`

  The user name of the new owner of the materialized view.

`new_name`

  The new name for the materialized view.

`new_schema`

  The new schema for the materialized view.

## Examples

To rename the materialized view `foo` to `bar`:

    ALTER MATERIALIZED VIEW foo RENAME TO bar;

## Compatibility

`ALTER MATERIALIZED VIEW` is a PostgreSQL extension.

## See Also

CREATE MATERIALIZED VIEW, DROP MATERIALIZED VIEW, REFRESH MATERIALIZED VIEW

Prev | Home | Next
ALTER LARGE OBJECT | Up | ALTER OPERATOR