Movatterモバイル変換

ALTER MATERIALIZED VIEW
Prev	Up	SQL Commands	Home	Next

ALTER MATERIALIZED VIEW

ALTER MATERIALIZED VIEW — change the definition of a materialized view

Synopsis

ALTER MATERIALIZED VIEW [ IF EXISTS ]nameaction [, ... ]ALTER MATERIALIZED VIEWname    [ NO ] DEPENDS ON EXTENSIONextension_nameALTER MATERIALIZED VIEW [ IF EXISTS ]name    RENAME [ COLUMN ]column_name TOnew_column_nameALTER MATERIALIZED VIEW [ IF EXISTS ]name    RENAME TOnew_nameALTER MATERIALIZED VIEW [ IF EXISTS ]name    SET SCHEMAnew_schemaALTER MATERIALIZED VIEW ALL IN TABLESPACEname [ OWNED BYrole_name [, ... ] ]    SET TABLESPACEnew_tablespace [ NOWAIT ]whereaction is one of:    ALTER [ COLUMN ]column_name SET STATISTICSinteger    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 | DEFAULT }    ALTER [ COLUMN ]column_name SET COMPRESSIONcompression_method    CLUSTER ONindex_name    SET WITHOUT CLUSTER    SET ACCESS METHODnew_access_method    SET TABLESPACEnew_tablespace    SET (storage_parameter [=value] [, ... ] )    RESET (storage_parameter [, ... ] )    OWNER TO {new_owner | CURRENT_ROLE | CURRENT_USER | SESSION_USER }

Description

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

You must own the materialized view to useALTER MATERIALIZED VIEW. To change a materialized view's schema, you must also haveCREATE privilege on the new schema. To alter the owner, you must be able toSET ROLE to the new owning role, and that role must haveCREATE 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 forALTER MATERIALIZED VIEW are a subset of those available forALTER TABLE, and have the same meaning when used for materialized views. See the descriptions forALTER TABLE for details.

Parameters

name: The name (optionally schema-qualified) of an existing materialized view.
column_name: Name of an existing column.
extension_name: The name of the extension that the materialized view is to depend on (or no longer dependent on, ifNO is specified). A materialized view that's marked as dependent on an extension is automatically dropped when the extension is dropped.
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 viewfoo tobar:

ALTER MATERIALIZED VIEW foo RENAME TO bar;

Compatibility

ALTER MATERIALIZED VIEW is aPostgres Pro extension.