Sua visualização do Power Query mostra dados antigos mesmo após atualizar a fonte. Isso acontece porque o Power Query armazena dados de visualização em cache para melhorar o desempenho. Os dados em cache podem ficar desatualizados ou corrompidos, impedindo a atualização da visualização. Este artigo explica como limpar o cache do Power Query para forçar uma nova visualização.
Principais conclusões: Limpando o cache de dados do Power Query
- Dados > Consultas e Conexões > Clique com o botão direito na consulta > Atualizar: Esta é a atualização padrão que pode não limpar o cache de visualização.
- Editor do Power Query > Arquivo > Opções e Configurações > Opções de Consulta > Carregamento de Dados > Limpar Cache: O método principal para excluir todos os dados de visualização em cache da pasta de trabalho.
- Fechar e reabrir a pasta de trabalho do Excel: Uma ação simples que limpa o cache na memória da sessão atual.
Por que o Power Query armazena dados de visualização em cache
O Power Query armazena uma cópia local dos dados da sua última operação de visualização. Esse cache permite que o Editor do Power Query exiba visualizações instantaneamente sem consultar a fonte toda vez que você clica em uma etapa. É um recurso de desempenho para projetar consultas.
O cache é separado dos dados carregados na sua planilha do Excel. Atualizar a consulta na planilha carrega novos dados nas células, mas nem sempre limpa o cache de visualização do editor. Problemas ocorrem quando a estrutura dos dados de origem muda, como colunas renomeadas, ou quando o arquivo de cache é corrompido. Nesses casos, o painel de visualização continua mostrando os metadados antigos e as linhas de amostra em cache.
Tipos de cache no Power Query
O Power Query usa dois caches principais. O cache de visualização é armazenado nos arquivos temporários do sistema e é usado apenas dentro da janela do Editor do Power Query. O cache do modelo de dados é usado pelo Modelo de Dados do Excel para Tabelas Dinâmicas e reside dentro do arquivo da pasta de trabalho. Limpar o cache de visualização não afeta os dados já carregados no seu relatório.
Passos para limpar o cache de dados do Power Query
Siga estas etapas para excluir os dados de visualização em cache e forçar o Power Query a buscar dados frescos da fonte.
- Abra o Editor do Power Query
No Excel, vá em Dados > Obter Dados > Iniciar Editor do Power Query. Alternativamente, encontre sua consulta em Dados > Consultas e Conexões, clique com o botão direito e selecione Editar. - Acesse as Opções de Consulta
Dentro do Editor do Power Query, clique em Arquivo na faixa de opções. Em seguida, selecione Opções e Configurações > Opções de Consulta. - Navegue até as Configurações de Carregamento de Dados
Na caixa de diálogo Opções de Consulta, selecione Carregamento de Dados no painel esquerdo. Esta seção contém configurações globais de como o Power Query lida com dados. - Limpe o Cache
No lado direito, localize a seção Cache. Clique no botão Limpar Cache. Uma mensagem de confirmação aparecerá. Clique em OK para prosseguir. Esta ação exclui todos os dados de visualização em cache de todas as consultas na pasta de trabalho atual. - Feche e Reabra o Editor
Feche a caixa de diálogo Opções de Consulta. Em seguida, feche a janela do Editor do Power Query. Reabra o editor editando sua consulta novamente. A visualização agora executará uma consulta nova na sua fonte de dados.
Método alternativo: Usando a janela de diagnóstico
Para usuários avançados, você pode usar um painel de diagnóstico oculto para limpar o cache de forma mais granular.
- Abra a Janela de Diagnóstico
No Editor do Power Query, pressione Ctrl+Shift no teclado e clique na opção Diagnóstico na guia Arquivo. Isso abre uma janela oculta. - Limpe Caches Específicos
Na janela Diagnóstico, vá para a guia Cache. Aqui você pode ver as entradas em cache. Você pode selecionar entradas específicas para limpar ou usar o botão Limpar Tudo para purgar tudo.
Se a visualização ainda não atualizar
Arquivo de origem está aberto ou bloqueado
Se sua consulta se conecta a um arquivo local, como uma pasta de trabalho do Excel ou CSV, certifique-se de que o arquivo de origem não esteja aberto em outro programa. Um arquivo aberto pode bloquear os dados, impedindo que o Power Query leia o conteúdo atualizado. Feche o arquivo de origem em todos os outros aplicativos e tente atualizar a visualização novamente.
Etapas da consulta referenciam colunas excluídas
Limpar o cache força uma nova leitura da fonte. Se a tabela de origem não tiver mais uma coluna nomeada em uma das etapas da sua consulta, a visualização falhará com um erro. Você deve editar a consulta para remover ou renomear a etapa que referencia a coluna ausente. Procure por uma etapa que use Remover Colunas, Renomear Colunas ou uma coluna calculada que referencie um nome de coluna antigo.
Credenciais de rede ou banco de dados expiraram
Para consultas de banco de dados ou fontes online, suas credenciais em cache podem ter expirado. Após limpar o cache, o Power Query pode solicitar que você insira novamente seus dados de login. Verifique as Configurações da Fonte de Dados em Arquivo > Opções e Configurações para gerenciar suas permissões salvas.
Atualização padrão vs. limpeza de cache: principais diferenças
| Item | Atualização Padrão da Consulta (Dados > Atualizar) | Limpeza do Cache do Power Query (Opções de Consulta) |
|---|---|---|
| Ação Principal | Reexecuta a consulta para atualizar os dados carregados na planilha do Excel | Exclui dados temporários de visualização usados dentro do Editor do Power Query |
| Efeito na Planilha | Atualiza tabelas, Tabelas Dinâmicas e o Modelo de Dados com novos dados | Nenhum efeito direto nos dados da planilha |
| Efeito no Painel de Visualização | Pode não atualizar se os metadados em cache estiverem desatualizados | Força a visualização a buscar metadados e linhas de amostra frescos da fonte |
| Localização | Faixa de opções principal do Excel, na guia Dados | Editor do Power Query em Arquivo > Opções e Configurações |
| Caso de Uso | Atualizar relatórios com os dados mais recentes da fonte | Corrigir erros de visualização após alterações no esquema da fonte |
Agora você pode limpar o cache de dados do Power Query para resolver uma visualização travada. Use o botão Limpar Cache em Opções de Consulta quando a estrutura dos dados de origem mudar. Para problemas persistentes, verifique suas etapas de consulta em busca de referências a nomes de colunas antigos. Experimente usar a janela de diagnóstico para mais controle sobre entradas específicas em cache.