バージョンごとのドキュメント一覧

ALTER MATERIALIZED VIEW

ALTER MATERIALIZED VIEW <refpurpose>change the definition of a materialized view</refpurpose> — マテリアライズドビューの定義を変更する

概要

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 ]


<phrase>where <replaceable class="parameter">action</replaceable> is one of:</phrase>

ここでactionは以下のいずれかです。

    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 }

説明

<title>Description</title>

<command>ALTER MATERIALIZED VIEW</command> changes various auxiliary properties of an existing materialized view. ALTER MATERIALIZED VIEWは既存のマテリアライズドビューの各種補助属性を変更します。

You must own the materialized view to use <command>ALTER MATERIALIZED VIEW</command>. To change a materialized view's schema, you must also have <literal>CREATE</literal> privilege on the new schema. To alter the owner, you must be able to <literal>SET ROLE</literal> to the new owning role, and that role must have <literal>CREATE</literal> 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.) ALTER MATERIALIZED VIEWを使用するためにはそのマテリアライズドビューを所有していなければなりません。 マテリアライズドビューのスキーマを変更するためには、新しいスキーマに対するCREATE権限を持たなければなりません。 所有者を変更するには、新しい所有者ロールに対してSET ROLEができなければなりません。また、そのロールはマテリアライズドビューのスキーマに対してCREATE権限を持たなければなりません。 (これらの制限により、マテリアライズドビューを削除し再作成することによってできる以上のことを所有者の変更で行えないようにします。 しかしスーパーユーザはいずれにせよ任意のビューの所有権を変更することができます。)

The statement subforms and actions available for <command>ALTER MATERIALIZED VIEW</command> are a subset of those available for <command>ALTER TABLE</command>, and have the same meaning when used for materialized views. See the descriptions for <link linkend="sql-altertable"><command>ALTER TABLE</command></link> for details. ALTER MATERIALIZED VIEW文で利用可能な副構文と操作は、ALTER TABLEで利用できるものの部分集合であり、マテリアライズドビューに対して使用した場合も同じ意味を持ちます。 詳細についてはALTER TABLEの説明を参照してください。

パラメータ

<title>Parameters</title>
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, if <literal>NO</literal> is specified). A materialized view that's marked as dependent on an extension is automatically dropped when the extension is dropped. マテリアライズドビューが依存する(もしくはNOが指定された場合にはもはや依存していない)拡張の名前です。 拡張に依存していると印をつけられたマテリアライズドビューは、拡張が削除されると自動的に削除されます。

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. マテリアライズドビューの新しいスキーマです。

<title>Examples</title>

To rename the materialized view <literal>foo</literal> to <literal>bar</literal>: マテリアライズドビューfooの名前をbarに変更します。

ALTER MATERIALIZED VIEW foo RENAME TO bar;

互換性

<title>Compatibility</title>

<command>ALTER MATERIALIZED VIEW</command> is a <productname>PostgreSQL</productname> extension. ALTER MATERIALIZED VIEWPostgreSQLの拡張です。

関連項目

<title>See Also</title> CREATE MATERIALIZED VIEW, DROP MATERIALIZED VIEW, REFRESH MATERIALIZED VIEW