NAME
ALTER_MATERIALIZED_VIEW - change the definition of a materialized view
SYNOPSIS
ALTER MATERIALIZED VIEW [ IF EXISTS ] \nname\n
\n
\naction\n [, ... ]
ALTER MATERIALIZED VIEW \nname\n
\n
[ NO ] DEPENDS ON EXTENSION \nextension_name\n
ALTER MATERIALIZED VIEW [ IF EXISTS ] \nname\n
\n
RENAME [ COLUMN ] \ncolumn_name\n TO \nnew_column_name\n
ALTER MATERIALIZED VIEW [ IF EXISTS ] \nname\n
\n
RENAME TO \nnew_name\n
ALTER MATERIALIZED VIEW [ IF EXISTS ] \nname\n
\n
SET SCHEMA \nnew_schema\n
ALTER MATERIALIZED VIEW ALL IN TABLESPACE \nname\n [ OWNED BY \nrole_name\n [, ... ] ]
\n
SET TABLESPACE \nnew_tablespace\n [ NOWAIT ]
where \naction\n is one of:
\n
ALTER [ COLUMN ] \ncolumn_name\n SET STATISTICS \ninteger\n
\n
ALTER [ COLUMN ] \ncolumn_name\n SET ( \nattribute_option\n = \nvalue\n [, ... ] )
\n
ALTER [ COLUMN ] \ncolumn_name\n RESET ( \nattribute_option\n [, ... ] )
\n
ALTER [ COLUMN ] \ncolumn_name\n SET STORAGE { PLAIN | EXTERNAL | EXTENDED | MAIN | DEFAULT }
\n
ALTER [ COLUMN ] \ncolumn_name\n SET COMPRESSION \ncompression_method\n
\n
CLUSTER ON \nindex_name\n
\n
SET WITHOUT CLUSTER
\n
SET ACCESS METHOD \nnew_access_method\n
\n
SET TABLESPACE \nnew_tablespace\n
\n
SET ( \nstorage_parameter\n [= \nvalue\n] [, ... ] )
\n
RESET ( \nstorage_parameter\n [, ... ] )
\n
OWNER TO { \nnew_owner\n | 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 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 be able to SET ROLE to 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
column_name
extension_name
new_column_name
new_owner
new_name
new_schema
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 (CREATE_MATERIALIZED_VIEW(7)), DROP MATERIALIZED VIEW (DROP_MATERIALIZED_VIEW(7)), REFRESH MATERIALIZED VIEW (REFRESH_MATERIALIZED_VIEW(7))