ALTER DYNAMIC TABLE¶

Sintaxe¶

ALTER DYNAMIC TABLE [ <name> ] { SUSPEND | RESUME }

ALTER DYNAMIC TABLE [ <name> ] REFRESH

ALTER DYNAMIC TABLE <name> SET
  [ TARGET_LAG = { '<num> { seconds | minutes | hours | days }'  | DOWNSTREAM } ]
  [ WAREHOUSE = <warehouse_name> ]

Parâmetros¶

name

Identificador da tabela a ser alterada. Se o identificador contiver espaços ou caracteres especiais, toda a cadeia de caracteres deverá ser delimitada por aspas duplas. Os identificadores delimitados por aspas duplas também diferenciam letras maiúsculas de minúsculas.

SUSPEND | RESUME

Especifica a ação a ser executada na tabela dinâmica:

• SUSPEND suspende as atualizações na tabela dinâmica. Se a tabela dinâmica for usada por outras tabelas dinâmicas, elas também serão suspensas.

• RESUME retoma as atualizações na tabela dinâmica. Retomar as operações em cascata a justante para todas as tabelas dinâmicas a jusante não suspensas manualmente.

Consulte Notas de uso para obter informações sobre como exibir o estado da tabela dinâmica.

REFRESH

Especifica que a tabela dinâmica deve ser atualizada manualmente. As tabelas dinâmicas suspensas pelo usuário e suspensas automaticamente podem ser atualizadas manualmente. Tabelas dinâmicas atualizadas manualmente mostram MANUAL como a atividade de atualização.

Consulte Notas de uso para obter informações sobre como exibir o estado da tabela dinâmica. Consulte a coluna REFRESH_TRIGGER de DYNAMIC_TABLE_REFRESH_HISTORY para obter informações sobre o status de atualização da tabela dinâmica.

SET ...

Especifica uma ou mais propriedades/parâmetros a serem definidos para a tabela (separados por espaços em branco, vírgulas ou novas linhas):

TARGET_LAG = { num { seconds | minutes | hours | days } | DOWNSTREAM }

Especifica o atraso para a tabela dinâmica:

'num seconds | minutes | hours | days'

Especifica a quantidade máxima de tempo que o conteúdo da tabela dinâmica deve atrasar as atualizações nas tabelas de base.

Por exemplo:

• Se os dados na tabela dinâmica não demorarem mais de 5 minutos, especifique 5 minutes.

• Se os dados na tabela dinâmica não demorarem mais de 5 horas, especifique 5 hours.

O valor mínimo é de 1 minuto. Se a tabela dinâmica A depender de outra tabela dinâmica B, o atraso mínimo de A deverá ser maior ou igual ao atraso de B.

DOWNSTREAM

Especifica que a tabela dinâmica deve ser atualizada se qualquer ancestral a jusante for atualizado.

WAREHOUSE = warehouse_name

Especifica o nome do warehouse que fornece os recursos de computação para atualizar a tabela dinâmica.

Você deve ter o privilégio USAGE neste warehouse para criar a tabela dinâmica.

Notas de uso¶

• Para alterar uma tabela dinâmica, você deve estar usando uma função que tenha o privilégio OPERATE na tabela.

• Se você quiser atualizar uma tabela dinâmica existente e precisar ver sua definição atual, chame a função GET_DDL.

• Consulte Estados da tabela dinâmica para obter uma lista de estados dinâmicos da tabela.

• Para visualizar as informações da tabela dinâmica, você pode:

  • Abrir Snowsight e selecione Activity » Dynamic Tables.

  • Chamar a função de tabela DYNAMIC_TABLE_GRAPH_HISTORY e examinar os resultados.

• 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¶

Alterar o tempo de atraso de uma tabela dinâmica chamada product para 1 hora:

ALTER DYNAMIC TABLE product SET
  TARGET_LAG = '1 hour';

Copy