Atualização incremental no Power BI: configure janelas

A atualização incremental no Power BI permite organizar a carga de uma tabela em períodos, mantendo histórico e atualizando uma janela recente. A escolha dessa janela precisa acompanhar como os dados chegam e são corrigidos. Se a operação altera vendas antigas, carregar apenas os últimos dias pode deixar o relatório rápido, porém incompleto.

1. Delimite a atualização incremental no Power BI

Comece por uma tabela de transações cujo volume cresce ao longo do tempo. Identifique quando aparecem linhas novas, quando valores são corrigidos e se existem exclusões. Uma dimensão pequena e totalmente mutável pode exigir outra estratégia, mesmo quando a tabela de vendas se beneficia de cargas por período.

A visão geral da Microsoft, consultada em 8 de outubro de 2026, descreve o gerenciamento de partições, que são partes da tabela separadas por período. Este roteiro considera dados importados; a inclusão de uma parte em DirectQuery, com consulta à origem, tem requisitos adicionais. Confirme o plano e a capacidade utilizados antes de escolher essa opção.

2. Escolha uma data de particionamento estável

Defina qual data coloca cada linha em um período. Prefira uma data cujo significado esteja estabelecido e que não seja alterada silenciosamente depois do fechamento. Guarde uma chave estável da transação para conferir duplicidades e rastrear correções.

Em um exemplo hipotético, uma venda registrada em março recebe uma correção de valor em maio. Ela continua pertencendo a março se essa for a data de particionamento. A correção não entrará numa janela que atualiza apenas maio. Registre separadamente a data da transação e a data da última alteração; elas têm funções diferentes e precisam de testes próprios.

3. Defina retenção e atualização separadamente

A retenção determina quanto histórico estará disponível no modelo. A janela de atualização determina quais períodos recentes serão relidos. As duas escolhas não são equivalentes: manter anos de histórico não significa que todos esses anos serão atualizados em cada execução.

Em uma configuração hipotética, a empresa conserva dois anos e atualiza noventa dias. Antes de adotar esses números, examine o histórico real de chegada e correção. Identifique alterações que ocorrem depois desse limite e combine um procedimento para elas. Não escolha uma janela curta apenas porque o teste ficou mais rápido; a cobertura das mudanças é o primeiro critério de correção.

4. Crie parâmetros com os nomes reservados

No Editor do Power Query, crie os parâmetros RangeStart e RangeEnd com tipo Data/Hora. Os nomes distinguem maiúsculas e minúsculas. Use valores de teste que carreguem uma amostra pequena, porém representativa de uma fronteira de período.

Segundo o procedimento oficial de configuração, esses valores filtram a amostra no Desktop; o serviço os substitui conforme a política publicada. Registre os parâmetros, a coluna filtrada e seus tipos na documentação do modelo. Se a origem usa uma chave inteira de data, siga a conversão de parâmetros descrita pela Microsoft, em vez de transformar toda a coluna indiscriminadamente.

5. Use fronteiras que não se sobreponham

Aplique a igualdade somente em um dos limites. O exemplo a seguir usa início inclusivo e fim exclusivo. Ele pressupõe que DataTransacao tem tipo compatível com os parâmetros e que os horários seguem uma convenção consistente.

Table.SelectRows(
    Fonte,
    each [DataTransacao] >= RangeStart
        and [DataTransacao] < RangeEnd
)

Teste uma linha exatamente no início, outra exatamente no fim e uma entre os limites. A linha no fim pertence ao período seguinte, não aos dois. A documentação alerta que igualdade nos dois extremos pode duplicar linhas entre partições. Inclua também mudança de mês e horários normalizados; compare as chaves esperadas, em vez de conferir apenas um total agregado.

6. Confirme que a origem recebe o filtro

Em fontes relacionais, verifique se o filtro de período chega à consulta executada na origem. Não basta observar que o resultado no Desktop contém poucos dias. Uma transformação pode carregar o conjunto inteiro e aplicar o filtro localmente, prejudicando a carga quando o serviço consultar várias partições.

A orientação de diagnóstico de atualização incremental recomenda conferir as consultas enviadas à fonte. Use evidências disponíveis no seu conector e no ambiente. O artigo sobre query folding no Power Query ajuda nessa verificação. Este teste avalia a execução do filtro; a política de janelas continua sendo uma decisão separada.

7. Configure a política e valide a primeira carga

Depois de aplicar o filtro, defina a política da tabela e publique em um ambiente de validação. A primeira atualização no serviço carrega o histórico previsto e aplica a política. Ela exige uma conferência diferente das atualizações posteriores, que trabalham com a janela móvel.

Registre contagem de linhas, chaves distintas, menor data, maior data e valores por mês. Compare essas informações com uma consulta de referência na origem para o mesmo intervalo. Se uma fonte limita o retorno, o painel pode conter dados truncados sem que uma soma isolada denuncie o problema. Investigue a carga antes de entregar o relatório aos usuários.

8. Planeje correções e exclusões antigas

Defina quem identifica uma alteração fora da janela e como os períodos afetados serão reprocessados. Os recursos disponíveis dependem do ambiente e da capacidade. Mantenha um procedimento validado, com reconciliação posterior, sem presumir que uma atualização comum relerá todo o histórico.

A detecção de mudanças usa uma coluna de alteração apropriada, mas não resolve automaticamente exclusões físicas. A documentação de configuração informa essa limitação. Em um exemplo hipotético, uma venda antiga removida da origem permanece no histórico não relido. Compare chaves e totais por período para encontrar a divergência. Se a origem registra uma marca de exclusão, teste também como essa marca afeta o resultado carregado.

9. Acompanhe duração junto com consistência

Registre início, término, resultado da atualização e período de dados disponível. Uma execução rápida com falha não entrega informação recente. Diferencie o horário da última carga bem-sucedida da maior data de transação; uma fonte pode não ter novos movimentos naquele dia.

Compare execuções com volumes e condições semelhantes antes de afirmar ganho de desempenho. Confira se o resultado comercial continua igual ao da referência. Para avaliar a resposta das páginas, consulte Performance Analyzer. Tempo de carga e tempo de interação são problemas diferentes, e uma melhoria no primeiro não comprova uma melhoria no segundo.

10. Mantenha um roteiro de liberação e recuperação

Antes de liberar, teste fronteiras, linha tardia, correção antiga, exclusão e alteração indevida da data de particionamento. A Microsoft alerta que mudar essa data pode criar conflitos entre partições. Guarde uma referência por período para repetir a conferência depois de mudanças na política.

O modelo editável de Vendas pode receber essa estratégia quando a origem e o histórico forem adequados. A configuração exige revisão técnica; ela não vem garantida por usar um template. Documente janela, retenção, evidências do filtro e procedimento de correção. Amplie o histórico somente depois de confirmar que a primeira carga e as seguintes preservam as transações esperadas.