ALTER MATERIALIZED VIEW

ALTER MATERIALIZED VIEW
Anterior	Acima	Comandos SQL	Principal	Próxima

ALTER MATERIALIZED VIEW — modifica a definição de uma visão materializada

Sinopse

ALTER MATERIALIZED VIEW [ IF EXISTS ] nome
    ação [, ... ]
ALTER MATERIALIZED VIEW nome
    [ NO ] DEPENDS ON EXTENSION nome_da_extensão
ALTER MATERIALIZED VIEW [ IF EXISTS ] nome
    RENAME [ COLUMN ] nome_da_coluna TO novo_nome_da_coluna
ALTER MATERIALIZED VIEW [ IF EXISTS ] nome
    RENAME TO novo_nome
ALTER MATERIALIZED VIEW [ IF EXISTS ] nome
    SET SCHEMA novo_esquema
ALTER MATERIALIZED VIEW ALL IN TABLESPACE nome
    [ OWNED BY nome_da_role [, ... ] ]
    SET TABLESPACE novo_espaço_de_tabelas [ NOWAIT ]

onde ação é uma entre:

    ALTER [ COLUMN ] nome_da_coluna
        SET STATISTICS inteiro
    ALTER [ COLUMN ] nome_da_coluna
        SET ( opção_de_atributo = valor [, ... ] )
    ALTER [ COLUMN ] nome_da_coluna
        RESET ( opção_de_atributo [, ... ] )
    ALTER [ COLUMN ] nome_da_coluna
        SET STORAGE { PLAIN | EXTERNAL | EXTENDED | MAIN | DEFAULT }
    ALTER [ COLUMN ] nome_da_coluna
        SET COMPRESSION método_de_compressão
    CLUSTER ON nome_do_índice
    SET WITHOUT CLUSTER
    SET ACCESS METHOD novo_método_de_acesso
    SET TABLESPACE novo_espaço_de_tabelas
    SET ( parâmetro_de_armazenamento [= valor] [, ... ] )
    RESET ( parâmetro_de_armazenamento [, ... ] )
    OWNER TO {
        novo_dono
      | CURRENT_ROLE
      | CURRENT_USER
      | SESSION_USER
    }

Descrição

O comando ALTER MATERIALIZED VIEW altera várias propriedades auxiliares de uma visão materializada existente.

É necessário ser o dono da visão materializada para poder executar o comando ALTER MATERIALIZED VIEW. Para alterar o esquema da visão materializada, também é necessário ter o privilégio CREATE no novo esquema. Para alterar o dono, é necessário ser capaz de executar o comando SET ROLE para a função de banco de dados (role) que será a nova dona, e esta função de banco de dados precisa possuir o privilégio CREATE no esquema da visão materializada. (Estas restrições impõem que alterar o dono não faz nada que não poderia ser feito excluindo e recriando a visão materializada. Entretanto, um superusuário pode alterar o dono de qualquer visão materializada.)

As diferentes formas e ações disponíveis para ALTER MATERIALIZED VIEW são um subconjunto das disponíveis para ALTER TABLE, tendo o mesmo significado quando usadas para visões materializadas. Para obter detalhes, veja as descrições em ALTER TABLE.

Parâmetros

nome: O nome (opcionalmente qualificado pelo esquema) da visão materializada existente.
nome_da_coluna: O nome de uma coluna existente.
nome_da_extensão: O nome da extensão da qual a visão materializada será dependente (ou não mais dependente, se for especificado NO). Uma visão materializada marcada como dependente de uma extensão é removida automaticamente quando a extensão é removida.
novo_nome_da_coluna: O novo nome para uma coluna existente.
novo_dono: O nome de usuário do novo dono da visão materializada.
novo_nome: O novo nome para a visão materializada.
novo_esquema: O novo esquema para a visão materializada.

Exemplos

Para mudar o nome da visão materializada foo para bar:

ALTER MATERIALIZED VIEW foo RENAME TO bar;

Conformidade

O comando ALTER MATERIALIZED VIEW é uma extensão do PostgreSQL ao padrão SQL.

Veja também

CREATE MATERIALIZED VIEW, DROP MATERIALIZED VIEW, REFRESH MATERIALIZED VIEW