Manual de Usuário

Abra a URL do sistema no navegador. A página inicial abrirá na área de Conexões, que é o ponto de partida para cadastrar, editar e usar os bancos.

1. No menu, clique em Nova Conexão.
2. Informe um nome para identificar a conexão, por exemplo: Produção, Homologação ou Banco Local.
3. Preencha os campos Host, Porta, Usuário e Senha.
4. Clique em Salvar.

Na tela de Conexões, você poderá:

• Visualizar todas as conexões cadastradas.
• Editar qualquer conexão para corrigir dados ou alterar senha.
• Remover conexões que não serão mais usadas.

Se uma conexão estiver incorreta, o sistema pode apresentar erro ao tentar listar bancos ou executar migrações. Nesse caso, revise os dados cadastrados.

Use a opção Comparar quando você quiser verificar as diferenças entre dois bancos antes de aplicar qualquer mudança.

1. Selecione a conexão de origem e a conexão de destino.
2. Escolha o database da origem e o database do destino.
3. Se quiser, escreva uma instrução para orientar a comparação.
4. Clique em Comparar.

O sistema mostrará quais estruturas existem em cada banco e quais alterações seriam necessárias para deixá-los alinhados.

Na opção Migrar, você pode transferir estruturas, registros ou ambos entre bancos.

1. Escolha a conexão de origem (ou Arquivo SQL para subir backups) e a conexão de destino.
2. Selecione os databases de origem (você pode marcar até 3 databases ou enviar até 3 arquivos SQL de uma vez para consolidar múltiplos SaaS).
3. Selecione a base de destino onde tudo será unificado.
4. Marque as opções desejadas:
   • Criar tabelas: cria as estruturas que ainda não existem no destino.
   • Migrar dados: copia os registros das tabelas.
   • Excluir tabelas: remove estruturas no destino antes de migrar. Use com cuidado.
5. Selecione a Estratégia de Consolidação de IDs (Merge de SaaS) ideal para seu cenário:
   • Nenhuma: Copia os IDs exatamente como estão. Pode gerar erros de colisão de chaves caso haja IDs duplicados nas origens.
   • Estratégia A - Deslocamento de IDs: Adiciona +1.000.000 de forma incremental para cada SaaS adicionado, ajustando as PKs e FKs numéricas correspondentes (ex: SaaS 1: IDs normais, SaaS 2: IDs +1M, SaaS 3: IDs +2M).
   • Estratégia B - Re-mapeamento Dinâmico: Zera as PKs originais para que o banco gere novos IDs contínuos e cria uma tabela "De-Para" em memória para reescrever as Foreign Keys (ex: user_id) em tempo de execução respeitando a ordem topológica das tabelas.
6. Clique em Iniciar Migração e acompanhe o log e os erros na tela de resultados.

Na opção IA, você pode fazer perguntas sobre SQL, entender melhor uma tabela ou receber sugestões de otimização.

1. Descreva sua dúvida em linguagem simples.
2. Se necessário, forneça contexto adicional sobre o banco ou a operação.
3. Leia a resposta com atenção e aplique a sugestão com cuidado.

Essa função é útil para tirar dúvidas rápidas, mas não substitui a análise de quem está responsável pela operação.

• Faça backup antes de executar migrações importantes.
• Teste primeiro em ambiente de homologação.
• Confirme se o usuário do banco possui as permissões corretas.
• Leia o SQL gerado antes de aplicar alterações.
• Se algo der errado, revise a conexão e os dados informados antes de tentar novamente.

Se encontrar erro de conexão, falha na migração ou dúvida sobre o resultado, verifique primeiro se:

• o host e a porta estão corretos;
• o usuário e a senha estão válidos;
• o banco informado realmente existe;
• o usuário tem permissão para as operações solicitadas.