PostgreSQL 中文参考文档
🌐 英文原版 官方 ↗

ALTER MATERIALIZED VIEW

ALTER MATERIALIZED VIEW — 更改一个物化视图的定义

Synopsis

ALTER MATERIALIZED VIEW [ IF EXISTS ] name
    action [, ... ]
ALTER MATERIALIZED VIEW name
    [ NO ] DEPENDS ON EXTENSION extension_name
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 | DEFAULT }
    ALTER [ COLUMN ] column_name SET COMPRESSION compression_method
    CLUSTER ON index_name
    SET WITHOUT CLUSTER
    SET ACCESS METHOD new_access_method
    SET TABLESPACE new_tablespace
    SET ( storage_parameter [= value] [, ... ] )
    RESET ( storage_parameter [, ... ] )
    OWNER TO { new_owner | CURRENT_ROLE | CURRENT_USER | SESSION_USER }

描述

ALTER MATERIALIZED VIEW 更改一个现有物化视图的多种辅助属性。

要使用 ALTER MATERIALIZED VIEW,你必须拥有该物化视图。要更改物化视图的模式,你还必须在新模式上具有 CREATE 特权。要更改拥有者,你必须能够 SET ROLE 到新的拥有角色,并且该角色必须在该物化视图的模式上具有 CREATE 特权。(这些限制强制确保更改拥有者不会做任何你通过删除并重建物化视图也无法做到的事情。不过,超级用户无论如何都可以更改任何视图的拥有者。)

ALTER MATERIALIZED VIEW 可用的语句子形式和动作是 ALTER TABLE 可用内容的一个子集,并且在用于物化视图时具有相同的含义。详细信息请参见 ALTER TABLE 中的描述。

参数

name

一个现有物化视图的名称(可以选择用模式限定)。

column_name

一个现有列的名称。

extension_name

该物化视图将要依赖的扩展的名称(或者,如果指定了 NO,则表示不再依赖)。被标记为依赖于某个扩展的物化视图会在该扩展被删除时自动删除。

new_column_name

一个现有列的新名称。

new_owner

该物化视图新拥有者的用户名。

new_name

该物化视图的新名称。

new_schema

该物化视图的新模式。

示例

把物化视图 foo 重命名为 bar:

ALTER MATERIALIZED VIEW foo RENAME TO bar;

兼容性

ALTER MATERIALIZED VIEW 是 PostgreSQL 的扩展。

另请参阅

CREATE MATERIALIZED VIEW, DROP MATERIALIZED VIEW, REFRESH MATERIALIZED VIEW