ALTER MATERIALIZED VIEW

Altera uma exibição materializada no esquema atual/especificado. As ações com suporte incluem:

  • Renomeação da exibição materializada.

  • Suspensão e retomada do uso e manutenção da exibição materializada.

  • Clusterização da exibição materializada.

  • Suspensão e retomada do reclustering da exibição materializada.

  • Descarte da clusterização da exibição materializada.

Para obter mais detalhes, consulte Como trabalhar com exibições materializadas.

Consulte também:

CREATE MATERIALIZED VIEW , DROP MATERIALIZED VIEW , SHOW MATERIALIZED VIEWS , DESCRIBE MATERIALIZED VIEW

Sintaxe

ALTER MATERIALIZED VIEW <name>
  {
  RENAME TO <new_name>                     |
  CLUSTER BY ( <expr1> [, <expr2> ... ] )  |
  DROP CLUSTERING KEY                      |
  SUSPEND RECLUSTER                        |
  RESUME RECLUSTER                         |
  SUSPEND                                  |
  RESUME                                   |
  SET {
    [ SECURE ]
    [ COMMENT = '<comment>' ]
    }                                      |
  UNSET {
    SECURE                                 |
    COMMENT
    }
  }
Copy

Parâmetros

name

Especifica o identificador da exibição materializada a ser alterada.

RENAME TO new_name

Esta opção permite que você renomeie uma exibição materializada.

O novo identificador deve ser único para o esquema no qual a exibição é criada. O novo identificador deve começar com um caractere alfabético e não pode conter espaços ou caracteres especiais a menos que toda a cadeia de caracteres do identificador esteja entre aspas duplas (por exemplo, "My object"). Os identificadores delimitados por aspas duplas também diferenciam letras maiúsculas de minúsculas. Para obter mais detalhes, consulte Requisitos para identificadores.

Você pode mover o objeto para um banco de dados e/ou esquema diferente enquanto opcionalmente renomeia o objeto. Para isso, especifique um valor qualificado new_name que inclua o novo banco de dados e/ou nome do esquema no formulário db_name.schema_name.object_name ou schema_name.object_name, respectivamente.

Nota

  • O banco de dados e/ou esquema de destino já deve existir. Além disso, um objeto com o mesmo nome não pode já existir no banco de dados de destino; caso contrário, a instrução retorna um erro.

  • É proibido mover um objeto para um esquema de acesso gerenciado a menos que o proprietário do objeto (ou seja, a função que tem o privilégio OWNERSHIP sobre o objeto) também possua o esquema de destino.

Note que a renomeação de uma exibição materializada não atualiza as referências a essa exibição. Por exemplo, se você criar uma exibição chamada V1 em uma exibição materializada, e depois renomear a exibição materializada, a definição de vista V1 ficará desatualizada.

CLUSTER BY expr#

Este comando clusteriza a exibição materializada. O clustering reordena as linhas na exibição materializada para aumentar o desempenho para consultas que filtram com base nas expressões-chave de clustering.

O expr# especifica uma expressão na qual deve ser feito o clustering da exibição materializada. Tipicamente, cada expressão é o nome de uma coluna na exibição materializada.

Para obter mais informações sobre clustering de exibições materializadas, consulte: Exibições materializadas e clustering. Para obter mais informações sobre clustering em geral, consulte: O que é clustering de dados?.

DROP CLUSTERING KEY

Este comando descarta o clustering da exibição materializada.

SUSPEND RECLUSTER

A opção SUSPEND RECLUSTER suspende o novo clustering da exibição materializada. Para obter mais informações sobre clustering de exibições materializadas, consulte Exibições materializadas e clustering.

RESUME RECLUSTER

A opção RESUME RECLUSTER retoma o reclustering da exibição materializada.

SUSPEND

A opção SUSPEND suspende a manutenção (atualizações) e o uso da exibição materializada. Enquanto a exibição estiver suspensa, as atualizações da tabela base não serão propagadas para a exibição materializada. A exibição materializada em si também é inacessível; se você tentar usá-la, você receberá uma mensagem de erro semelhante a:

Failure during expansion of view 'MV1':
  SQL compilation error: Materialized View MV1 is invalid.
  Invalidation reason: Marked Materialized View as invalid manually.

Se você suspender uma exibição materializada clusterizada, suspender a exibição implicitamente suspenderá o reclustering dessa exibição.

RESUME

A opção RESUME permite que você retome usando a exibição materializada. Isso também retoma a manutenção da exibição materializada. Se a exibição estiver clusterizada, ela também retomará implicitamente o reclustering desta exibição.

SET ...

Especifica a propriedade a ser definida para a exibição materializada:

SECURE

Esta opção transforma a exibição em uma exibição segura. Para obter mais informações sobre exibições seguras, consulte Como trabalhar com exibições seguras.

COMMENT = 'string_literal'

Esta opção define um comentário para a exibição materializada. O comentário não tem efeito sobre o comportamento da exibição, mas pode fornecer informações úteis para as pessoas que usam ou mantêm a exibição.

UNSET ...

Especifica a propriedade a ser removida para a exibição materializada:

  • SECURE

  • TAG tag_name [ , tag_name ... ]

  • COMMENT

Notas de uso

  • Use o comando ALTER VIEW para definir/remover uma política de mascaramento, política de acesso a linhas ou tag em/de uma exibição materializada.

  • Em relação aos metadados:

    Atenção

    Os clientes devem garantir que nenhum dado pessoal (exceto para um objeto do usuário), dados sensíveis, dados controlados por exportação ou outros dados regulamentados sejam inseridos como metadados ao usar o serviço Snowflake. Para obter mais informações, consulte Campos de metadados no Snowflake.

Exemplos

Renomear uma exibição materializada:

ALTER MATERIALIZED VIEW table1_MV RENAME TO my_mv;
Copy

Clusterizar uma exibição materializada:

ALTER MATERIALIZED VIEW my_mv CLUSTER BY(i);
Copy

Suspender o clustering de uma exibição materializada, mas não a utilização da exibição:

ALTER MATERIALIZED VIEW my_mv SUSPEND RECLUSTER;
Copy

Retomar o clustering de uma exibição materializada:

ALTER MATERIALIZED VIEW my_mv RESUME RECLUSTER;
Copy

Suspender todo o uso e a manutenção automática da exibição materializada especificada:

ALTER MATERIALIZED VIEW my_mv SUSPEND;
Copy

Retomar todo o uso e manutenção automática da exibição materializada especificada:

ALTER MATERIALIZED VIEW my_mv RESUME;
Copy

Parar o clustering de uma exibição materializada:

ALTER MATERIALIZED VIEW my_mv DROP CLUSTERING KEY;
Copy

Modificar a exibição para ser uma exibição segura:

ALTER MATERIALIZED VIEW mv1 SET SECURE;
Copy

Adicionar ou substituir o comentário para uma exibição materializada:

ALTER MATERIALIZED VIEW mv1 SET COMMENT = 'Sample view';
Copy