Manual MySync

Erros Comuns e Como Resolver

Encontrou algum problema? Abaixo estão os erros mais recorrentes, as causas prováveis e o que fazer. Siga a ordem: conexão → permissões → estrutura → execução.

Diagnóstico rápido (checklist)

  • Conexões ORIGEM e DESTINO testam OK? (veja Testar Conexão)
  • Usuário tem permissões adequadas? (ORIGEM: leitura; DESTINO: escrita e, quando aplicável, criar/limpar)
  • Tabela do DESTINO está preparada? (veja Preparar Tabela)
  • Há espaço em disco suficiente e recursos no servidor?
  • O tamanho do lote é adequado à tabela e ao ambiente?

Mensagens frequentes

1) “Usuário ou senha inválidos”

Causa: credenciais incorretas.

Como resolver:

  • Revise usuário e senha (maiúsculas/minúsculas e caracteres especiais).
  • Confirme se está testando no servidor certo (host/porta).

2) “Servidor inacessível / tempo esgotado”

Causa: host ou porta incorretos, firewall/rede bloqueando, servidor fora do ar.

Como resolver:

  • Verifique host (nome ou IP) e porta (MySQL 3306, PostgreSQL 5432 por padrão).
  • Cheque com a TI se há liberação de rede/VPN entre as máquinas.
  • Confirme se o servidor está online e respondendo conexões.

3) “Banco de dados não encontrado”

Causa: nome do banco digitado de forma diferente do criado.

Como resolver: use o nome exatamente como existe no servidor (sem espaços/letras a mais).

4) “Schema inválido” (PostgreSQL)

Causa: schema informado não existe ou não é o usado pela aplicação.

Como resolver: normalmente é public; confirme com o responsável.

5) “Permissão negada” (no DESTINO)

Causa: usuário sem privilégio para criar, limpar (truncate) ou inserir dados.

Como resolver:

  • Peça à TI as permissões necessárias: CREATE/TRUNCATE/INSERT/UPDATE conforme o caso.
  • Se não puder elevar permissão, ajuste o fluxo para não exigir a operação bloqueada.

6) “Tabela não encontrada”

Causa: a tabela de destino ainda não existe.

Como resolver:

  • Use a função de Criar Tabela no Destino ou crie manualmente.
  • Verifique se o nome coincide com o esperado pela sincronização.

7) “Coluna/tipo incompatível”

Causa: estrutura do destino diferente da origem (nomes, tipos ou tamanhos de campos).

Como resolver:

  • Ajuste a estrutura no destino para refletir os campos essenciais da origem.
  • Valide tipos de data/hora (timezone/formato) e precisão de numéricos.

8) Lentidão / estouro de memória

Causa: lotes muito grandes, índices pesados durante inserção, servidor sobrecarregado.

Como resolver:

  • Reduza o tamanho do lote e tente novamente.
  • Para cargas completas, considere criar índices depois da carga.
  • Rode sincronizações grandes em horários de baixo movimento.
  • Veja Performance (Lotes).

Específico por banco

MySQL

  • Porta padrão: 3306.
  • Verifique sql_mode em casos de validação rígida de dados.
  • Collation/charset podem afetar acentos/emoji; alinhe origem e destino quando possível.

PostgreSQL

  • Porta padrão: 5432.
  • Confirme o schema (geralmente public).
  • Tipos timestamp with/without time zone exigem atenção ao fuso.

Como coletar informações para suporte

  • Print da tela do erro e do capítulo do manual que estava seguindo.
  • Nome das tabelas envolvidas (origem e destino).
  • Quantidade aproximada de registros e tamanho do lote configurado.
  • Data/hora da execução, ambiente (dev/homolog/produção) e se havia outras cargas rodando.

Próximos passos