Como resetar a replicação pela tela de Admin

Status: Aprovado · Responsável: Gustavo Madruga · Atualizado em: 2026-07-06

Esta tela dispara o reset da replicação: ela limpa e recria o canal que leva os dados até os aplicativos de BI nos celulares. Use só quando o suporte orientar — depois do reset, todos os celulares fazem uma sincronização completa na próxima vez que abrirem o app.

Operação destrutiva

O reset afeta todos os usuários de celular. Faça em horário de baixo movimento e só com orientação do suporte. Os detalhes técnicos, o que acontece em cada etapa e como recuperar estão no runbook Resetar Powersync.

Quando (e por que) usar

• O armazenamento da replicação cresceu demais e precisa ser enxugado (limpeza periódica combinada com o suporte).
• Houve uma mudança de estrutura de dados que exige que os celulares refaçam a carga do zero.
• Diagnóstico de divergência entre o banco e os aplicativos — como último recurso, sempre com o suporte.

Não faça em horário comercial: com muitos celulares conectados, todos reconectam ao mesmo tempo e sentem uma pausa de alguns segundos.

Antes de começar

• Acesse o sistema com seu login @xadm.com.br.
• No topo da tela, clique em Admin.
• Combine o horário com o suporte — de preferência fora do horário de pico.

Passo a passo

1. No painel de Administração, localize o cartão Resetar replicação PowerSync e clique no botão de mesmo nome.

   

2. Abre uma janela de confirmação. Preencha:

   • Motivo — por que está fazendo o reset (ex.: orientação do suporte).
   • Operador — seu e-mail.
   • O campo de confirmação — digite exatamente a palavra RESETAR.

   

3. Confira tudo e clique em confirmar. Acompanhe o andamento na tela de detalhe que abre em seguida — ela recarrega sozinha e mostra cada etapa até concluir, terminando em SUCESSO (verde) ou ERRO (vermelho).

4. Enquanto um reset estiver em andamento, o botão fica desabilitado — só é possível um reset por vez. O histórico de resets aparece no próprio painel de Admin.

Quando der erro, faça isso

O botão de confirmar não habilita: confira se você digitou a palavra RESETAR exatamente (maiúsculas, sem espaços) e se preencheu Motivo e Operador.

O reset parou no meio (uma etapa ficou em vermelho): não tente de novo às cegas — chame o suporte com o horário e a etapa que falhou. O passo a passo de recuperação está no runbook Resetar Powersync.

Depois do reset, um celular não atualiza: peça ao usuário para abrir o app conectado à internet e aguardar — a primeira sincronização após o reset é completa e pode demorar mais que o normal.