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.
- dynamic tables
- explain changes
- snowflake sql
- refresh
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
- SnowflakeGA
Geração de documentos em PDF, Word e PowerPoint no Snowflake CoWork
O Snowflake CoWork agora gera arquivos PDF, Word, PowerPoint e HTML diretamente de suas análises usando a ferramenta de execução de código do Cortex Agent.
snowflake cowork · cortex agent - SnowflakePublic Preview
Cortex Agent SDK para Python e TypeScript no Snowflake
O Cortex Agent SDK permite criar aplicações que utilizam Cortex Agents e Cortex Code em Python e TypeScript.
cortex agents · python - SnowflakeAtualização
Mensagens de erro mais detalhadas na classificação de dados sensíveis
A view DATA_CLASSIFICATION_LATEST agora traz mensagens de erro específicas e códigos do Snowflake para falhas na classificação.
data governance · trust center