Quando você edita o esquema de um banco de dados do Notion adicionando, renomeando ou excluindo uma propriedade, a visualização pode continuar exibindo o esquema antigo por vários segundos ou até minutos. Essa exibição desatualizada não é um bug, mas sim resultado direto do cache de visualização do lado do cliente do Notion, que armazena um instantâneo da estrutura do banco de dados para reduzir requisições ao servidor. O cache foi projetado para melhorar o desempenho, mas pode causar confusão quando você espera um feedback visual imediato após uma alteração no esquema. Este artigo explica como o cache de visualização funciona, por que ele atrasa as atualizações e como forçar uma atualização para ver suas alterações instantaneamente.
Principais conclusões: Forçando uma visualização atualizada após alterações no esquema
- Ctrl + R ou Cmd + R: Atualiza a página atual e limpa o cache de visualização do lado do cliente para todos os bancos de dados visíveis.
- Alternar tipo de visualização (Tabela → Quadro → Tabela): Dispara uma nova busca completa do esquema do banco de dados a partir do servidor, ignorando o cache desatualizado.
- Fechar e reabrir a aba do banco de dados: Força o Notion a recarregar os metadados do banco de dados, incluindo o esquema atualizado.
Como o cache de visualização do Notion atrasa as atualizações de esquema
O Notion armazena uma cópia da estrutura de cada visualização do banco de dados no cache local do navegador. Esse cache inclui nomes de propriedades, tipos de propriedades e as configurações atuais de classificação/filtro. Quando você modifica uma propriedade do esquema, o Notion envia a alteração para o servidor imediatamente, mas a visualização do lado do cliente não invalida automaticamente sua cópia em cache. A visualização em cache continua exibindo o esquema antigo até que um dos vários gatilhos force uma nova busca. O atraso geralmente dura de 5 a 30 segundos, dependendo da velocidade da sua rede e do tamanho do banco de dados.
A causa raiz técnica
O Notion usa um padrão de busca de dados chamado atualizações otimistas de interface. Quando você edita uma propriedade, a interface atualiza o cache de forma otimista, mas a resposta do servidor pode sobrescrever essa alteração se o esquema do lado do servidor for diferente. Para edições de esquema, o Notion não trata a alteração como um evento de invalidação de alta prioridade. Em vez disso, ele espera por uma atualização de página, uma alternância de visualização ou um ciclo de expiração periódica do cache. Esse design minimiza a carga no servidor, mas cria o problema de exibição desatualizada.
Quando o cache falha em atualizar
A exibição desatualizada é mais perceptível quando você:
- Renomeia uma propriedade e o nome antigo ainda aparece nos cabeçalhos das colunas ou nos menus suspensos de filtro.
- Exclui uma propriedade, mas a coluna permanece visível com células vazias.
- Altera o tipo de uma propriedade e a visualização ainda mostra a formatação antiga.
Esses sintomas ocorrem porque os metadados da visualização em cache não foram invalidados.
Passos para forçar uma visualização atualizada após edições no esquema
Use estes métodos em ordem. O primeiro método é o mais rápido e funciona na maioria dos casos.
Método 1: Atualizar a página do navegador
- Pressione Ctrl + R no Windows ou Cmd + R no Mac
Isso recarrega a página inteira e limpa o cache em memória para todos os bancos de dados na página. - Aguarde a página recarregar completamente
A visualização do banco de dados agora deve exibir o esquema atualizado. Se o esquema antigo persistir, vá para o Método 2.
Método 2: Alternar o tipo de visualização
- Clique no nome da visualização atual no topo do banco de dados
O nome da visualização é mostrado ao lado de uma seta suspensa. Uma lista de tipos de visualização aparece. - Selecione um tipo de visualização diferente
Por exemplo, se você está em uma visualização de Tabela, selecione Quadro. Isso força o Notion a solicitar o esquema completo do servidor. - Volte ao tipo de visualização original
Clique no nome da visualização novamente e selecione o tipo original. O esquema agora deve estar atualizado.
Método 3: Fechar e reabrir a aba do banco de dados
- Clique no nome do banco de dados na barra lateral ou no breadcrumb do Notion
Isso abre o banco de dados em uma nova aba ou navega para longe da visualização atual. - Reabra o banco de dados pela barra lateral
Clique no mesmo nome do banco de dados novamente. O carregamento da nova página dispara uma busca completa do esquema.
Se o Notion ainda mostrar o esquema antigo após atualizar
Recarregamento forçado do navegador
Uma atualização padrão de página pode não limpar o cache em disco do navegador. Use um recarregamento forçado:
- Windows: Pressione Ctrl + Shift + R.
- Mac: Pressione Cmd + Shift + R.
Isso ignora o cache local e força o download de todos os recursos da página, incluindo metadados do banco de dados.
Limpar o cache do aplicativo Notion no desktop
Se você usa o aplicativo de desktop do Notion, o cache é armazenado em um local separado:
- Abra o Notion e vá para Configurações e Membros > Configurações > Notificações e Configurações
Role até o final do painel de Configurações. - Clique em Limpar Cache
Isso exclui todos os instantâneos de visualização do banco de dados locais. Reinicie o Notion após limpar.
Verifique atrasos de sincronização no servidor
Em casos raros, a alteração no esquema pode não ter sido salva no servidor. Abra o banco de dados em uma janela de navegador privada ou anônima. Se o esquema antigo aparecer lá também, a alteração não foi salva. Volte ao banco de dados original, faça a edição do esquema novamente e confirme clicando fora do editor de propriedades ou pressionando Enter.
| Método de atualização | Velocidade | Eficácia |
|---|---|---|
| Ctrl + R ou Cmd + R | Rápido | Funciona em 90% dos casos |
| Alternar tipo de visualização | Médio | Funciona quando a atualização de página falha |
| Fechar e reabrir aba | Lento | Confiável para todos os cenários |
| Recarregamento forçado (Ctrl + Shift + R) | Rápido | Limpa cache em disco |
| Limpar cache do aplicativo Notion desktop | Lento | Apenas para usuários do aplicativo desktop |
O cache de visualização do Notion é um recurso de desempenho que pode ocultar edições de esquema por até 30 segundos. Use Ctrl + R ou Cmd + R como sua primeira ação para atualizar a visualização. Se isso não funcionar, alterne o tipo de visualização ou feche e reabra a aba do banco de dados. Para problemas persistentes, faça um recarregamento forçado ou limpe o cache do aplicativo desktop. Entender esse comportamento evita solução de problemas desnecessária e garante que suas alterações de esquema apareçam quando você espera.