Pular para o conteúdo
Lucas Lessa
Voltar para as notícias
SnowflakeGAImpacto: Médio

Preveja o comportamento de refresh de dynamic tables com EXPLAIN CHANGES

Use EXPLAIN CHANGES para prever se o próximo refresh de uma dynamic table será incremental ou exigirá re inicialização, sem aplicar alterações.

O que mudou

O comando EXPLAIN CHANGES permite simular o comportamento do próximo refresh de uma dynamic table. Você pode usá-lo antes de executar um refresh manual ou antes de aplicar mudanças via DDL, identificando se a operação rodará de forma incremental ou se exigirá reprocessar todos os dados.### Para que serveImagine que você precisa alterar o target lag de uma dynamic table em produção e quer saber se essa alteração vai disparar uma recarga completa dos dados. Com este recurso você consegue:- Prever se o próximo refresh será incremental ou total.- Validar o impacto de alterações de DDL antes de aplicá-las.- Identificar se uma alteração específica vai causar falhas no refresh.### Como usarPara testar o impacto de uma alteração de DDL sem aplicá-la, adicione EXPLAIN CHANGES antes do comando:sqlEXPLAIN CHANGES ALTER DYNAMIC TABLE dt_orders SET TARGET_LAG = '5 minutes';O que acontece nesse código:1. O Snowflake analisa o comando DDL e o estado atual da tabela.2. A alteração não é aplicada na tabela real.3. O sistema retorna metadados indicando o efeito previsto para o refresh, incluindo se a ação será incremental.Para verificar o motivo de um reprocessamento completo ao remover uma região congelada:sqlEXPLAIN CHANGES ALTER DYNAMIC TABLE dt_orders UNSET FROZEN WHERE;O que acontece nesse código:1. O comando avalia o impacto de remover a restrição da região congelada.2. O motor retorna uma propriedade indicando que a ação exigirá re inicialização.3. A propriedade effective_refresh_action_reason detalha o motivo da mudança.### O que retornaCampo | Descrição---|---operation | A operação DDL testada no comando.domain | O domínio do objeto afetado, retornado como DYNAMIC_TABLE para a tabela dinâmica.name | O nome qualificado da dynamic table.changes | Lista de alterações que a instrução faria na estrutura.effects | Vetor contendo o tipo de efeito e as propriedades previstas para o refresh.### Limitações e requisitosO recurso está disponível em General Availability. A previsão reflete o estado atual dos dados e do objeto no momento exato em que a consulta é executada. A análise cobre apenas a dynamic table alvo da instrução, sem verificar outras tabelas encadeadas que a consulta leia.

Ver nota oficial do Snowflake

Predict dynamic table refresh behavior with EXPLAIN CHANGES (General availability)

Resumo e explicação gerados por IA a partir da release note oficial. Em caso de dúvida, a documentação oficial da plataforma prevalece.

Relacionadas