Documentation PostgreSQL 14.22 » Référence » Commandes SQL » ALTER MATERIALIZED VIEW

Précédent | Niveau supérieur | Suivant
ALTER LARGE OBJECT | Sommaire | ALTER OPERATOR

## ALTER MATERIALIZED VIEW

ALTER MATERIALIZED VIEW — modifier la définition d'une vue matérialisée

## Synopsis

    ALTER MATERIALIZED VIEW [ IF EXISTS ] nom
        action [, ... ]
    ALTER MATERIALIZED VIEW nom
        [ NO ] DEPENDS ON EXTENSION nom_extension
    ALTER MATERIALIZED VIEW [ IF EXISTS ] nom
        RENAME [ COLUMN ] nom_colonne TO nouveau_nom_colonne
    ALTER MATERIALIZED VIEW [ IF EXISTS ] nom
        RENAME TO nouveau_nom
    ALTER MATERIALIZED VIEW [ IF EXISTS ] nom
        SET SCHEMA nouveau_schéma
    ALTER MATERIALIZED VIEW ALL IN TABLESPACE nom [ OWNED BY nom_role [, ... ] ]
        SET TABLESPACE nouveau_tablespace [ NOWAIT ]

    où action fait partie
    de :

        ALTER [ COLUMN ] nom_colonne SET STATISTICS integer
        ALTER [ COLUMN ] nom_colonne SET ( option_attribut [= valeur] [, ... ] )
        ALTER [ COLUMN ] nom_colonne RESET ( option_attribut [, ... ] )
        ALTER [ COLUMN ] nom_colonne SET STORAGE { PLAIN | EXTERNAL | EXTENDED | MAIN }
        ALTER [ COLUMN ] column_name SET COMPRESSION compression_method
        CLUSTER ON nom_index
        SET WITHOUT CLUSTER
        SET TABLESPACE nouveau_tablespace
        SET ( paramètre_stockage = valeur [, ... ] )
        RESET ( paramètre_stockage [, ... ] )
        OWNER TO { nouveau_propriétaire | CURRENT_ROLE | CURRENT_USER | SESSION_USER }

## Description

`ALTER MATERIALIZED VIEW` modifie les différentes propriétés d'une vue matérialisée existante.

Vous devez être le propriétaire d'une vue matérialisée pour utiliser `ALTER MATERIALIZED VIEW`. Pour changer le schéma d'une vue matérialisée, vous devez aussi avoir le droit `CREATE` sur le nouveau schéma. Pour modifier le propriétaire, vous devez aussi être un membre direct ou indirect du nouveau rôle propriétaire et ce rôle doit avoir le droit `CREATE` sur le schéma de la vue matérialisée. (Ces restrictions assurent que la modification du propriétaire ne vous permet pas plus que ce que vous pourriez faire en supprimant ou récréant la vue matérialisée. Néanmoins, un super-utilisateur peut modifier le propriétaire d'une vue.)

Les différentes formes et actions disponibles pour `ALTER MATERIALIZED VIEW` sont un sous-ensemble de celles disponibles pour `ALTER TABLE`, et ont la même signification quand elles sont utilisées pour les vues matérialisées. Pour plus de détails, voir les descriptions sur `ALTER TABLE`.

## Paramètrs

`nom`

  Nom, potentiellement qualifié du nom du schéma, d'une vue matérialisée existante.

`nom_colonne`

  Nom d'une colonne déjà existante.

`nom_extension`

  Nom de l'extension dont dépend la vue matérialisée (ou dont elle ne dépend plus si le mot-clé `NO` est ajouté). Une vue matérialisée dépendante d'une extension est automatiquement supprimée quand l'extension est supprimée.

`nouveau_nom_colonne`

  Nouveau nom d'une colonne existante.

`nouveau_propriétaire`

  Nom utilisateur du nouveau propriétaire de la vue matérialisée.

`nouveau_nom`

  Nouveau nom de la vue matérialisée.

`nouveau_schéma`

  Nouveau schéma de la vue matérialisée.

## Exemples

Renommer la vue matérialisée `truc` en `chose` :

    ALTER MATERIALIZED VIEW truc RENAME TO chose;

## Compatibilité

`ALTER MATERIALIZED VIEW` est une extension PostgreSQL.

## Voir aussi

CREATE MATERIALIZED VIEW, DROP MATERIALIZED VIEW, REFRESH MATERIALIZED VIEW