Cache de painéis de controlo

Um painel de controlo guarda em cache o resultado de cada gráfico que desenha. A primeira pessoa a abrir um painel de controlo executa as respetivas consultas no armazém de dados; todos os que o abrem depois obtêm o resultado guardado, e é por isso que uma segunda visualização é muito mais rápida do que a primeira.

Um resultado em cache é descartado — e a visualização seguinte volta a consultar o armazém — em duas situações: a tabela por trás do gráfico é republicada ou o resultado atinge o fim do seu tempo de vida na cache.

Republicar uma tabela limpa os respetivos resultados em cache

Quando uma execução de um fluxo de trabalho republica uma tabela, todos os gráficos que leem essa tabela descartam imediatamente os respetivos resultados em cache. A pessoa que abrir o painel de controlo a seguir vê os números atualizados, sem esperar e sem forçar manualmente uma atualização.

Isto significa que um painel de controlo nunca mostra números anteriores à atualização por causa da cache. Se um painel de controlo parecer desatualizado após uma execução de um fluxo de trabalho, a causa é o fluxo de trabalho — verifique se a execução terminou e se republicou a tabela esperada — e não a cache.

Tempo de vida da cache

Cada resultado em cache também tem um tempo de vida, após o qual expira por si próprio. O valor predefinido é 1 hora.

O tempo de vida não é o que mantém um painel de controlo atualizado — é a republicação que o faz. Assim, em dados que só mudam quando um fluxo de trabalho é executado, um tempo de vida curto não traz nada e custa muito: qualquer visualização depois de o último resultado expirar volta a consultar o armazém desde o início. Os painéis de controlo usados em picos — uma revisão matinal, um fecho de fim de mês — pagam esse custo em quase todos os carregamentos.

O valor predefinido era de 5 minutos até agosto de 2026. Era curto porque a republicação não limpava de forma fiável os resultados em cache, pelo que a expiração era a única coisa que mantinha um painel de controlo atualizado. Agora que a republicação os limpa, uma hora é simultaneamente seguro e muito mais barato.

Aumente-o ainda mais em tabelas que mudam com menos frequência — um dia adequa-se a uma que é recarregada durante a noite — e o fluxo de trabalho que recarrega a tabela continua a limpar a cache no momento em que os novos dados chegam.

Alterar o tempo de vida da cache

Defina o tempo de vida em segundos, numa base de dados ou num conjunto de dados individual. Um valor no conjunto de dados prevalece sobre o valor da respetiva base de dados, e o valor predefinido de 1 hora aplica-se onde não definiu nenhum dos dois. Alterar qualquer um deles requer a permissão de edição correspondente na área Dashboards.

Para todos os conjuntos de dados de uma base de dados:

Aceda a Data → Databases na área Dashboards
Clique no ícone de edição da base de dados
Abra o separador Avançado e depois Performance
Introduza um valor em segundos em Chart cache timeout — por exemplo, 3600 para uma hora
Clique em Finish

Para um único conjunto de dados:

Aceda a Data → Datasets
Clique no ícone de edição do conjunto de dados
Abra o separador Definições
Introduza um valor em segundos em Cache timeout
Clique em Guardar

Dois valores têm significados especiais: 0 significa que nunca expira, pelo que o resultado só é limpo por uma republicação, e -1 desativa por completo a cache dessa base de dados ou conjunto de dados.

A alteração aplica-se aos resultados guardados em cache a partir desse momento. Os resultados que já estão na cache mantêm o tempo de vida com que foram guardados até expirarem ou a tabela ser republicada.

Atualizar um painel de controlo manualmente

Raramente é necessário, mas pode descartar por si os resultados em cache de um painel de controlo: abra o menu junto a Edit dashboard e escolha Force refresh dashboard. Se um gráfico estiver a servir um resultado mais antigo, uma nota no canto superior direito indica há quanto tempo os dados foram guardados em cache, e clicar nela força a mesma atualização.

Prefira qualquer uma destas opções a recarregar a página do navegador — um recarregamento do navegador volta a pedir os gráficos mas continua a receber os resultados em cache.