Conexões & Drivers

Aqui você cria e gerencia suas conexões com MySQL e PostgreSQL. Depois de conectadas, você poderá navegar bancos, schemas e executar as 24 ações por tabela.

Criar uma conexão

1) Escolher o tipo

• Acesse Conexões → NOVA CONEXÃO.
• Selecione MySQL ou PostgreSQL.

2) Preencher os campos

Para MySQL

• Host: endereço do servidor (ex.: db.minhaempresa.com ou IP).
• Porta: 3306 (padrão, altere se sua TI usar outra).
• Banco: nome do database (ex.: erp_prod).
• Usuário e Senha: credenciais com permissões mínimas necessárias.
• Opções (quando disponíveis):
  • SSL/TLS: habilite se o servidor exigir conexão segura.
  • Timeout: tempo de espera para conectar/executar (evita travamentos).

Para PostgreSQL

• Host: endereço do servidor.
• Porta: 5432 (padrão).
• Banco: nome do database (ex.: erp_prod).
• Schema: em geral public (informe outro se sua empresa padroniza).
• Usuário e Senha.
• Opções:
  • SSL/TLS se seu servidor exigir.
  • Timeout de conexão/execução.

Dica: se você usa VPN, conecte-se antes de testar a conexão.

Testar e salvar

1. Depois de preencher, toque em Testar Conexão.
2. Se o teste OK, toque em Salvar.
3. Sua conexão aparecerá na lista. Toque nela para Conectar.

Caso o teste falhe, veja a seção Erros comuns de conexão mais abaixo.

Gerenciar conexões

• Editar: abra a conexão e ajuste qualquer campo; salve e teste novamente.
• Duplicar: crie uma cópia para outro ambiente (ex.: trocar apenas o Banco ou Host).
• Excluir: remove a conexão da lista (não altera nada no servidor).
• Padrão: defina uma conexão favorita para abrir primeiro.
• Várias conexões: você pode manter conexões MySQL e PostgreSQL lado a lado e alternar conforme a necessidade.

Drivers e compatibilidade

• MySQL: compatível com MySQL Community/Enterprise (5.7+ e 8.x). Recursos como partições e engines dependem do servidor.
• PostgreSQL: compatível com PG 11+ (recomendado 12+). Funções/Extensions variam por ambiente.
• Charset/Collation: respeite as definições do servidor. Ajustes são feitos nas telas de estrutura quando disponíveis.

Boas práticas de segurança

• Use contas com permissão mínima (leitura ou leitura/escrita conforme o trabalho).
• Mantenha as credenciais apenas no aparelho do usuário autorizado (o app usa armazenamento seguro).
• Prefira HTTPS na API e conexões com SSL/TLS quando o servidor suportar.
• Evite editar produção sem política clara de backup e janela de manutenção.

Erros comuns de conexão (e como resolver)

“Usuário ou senha inválidos”

• Revise as credenciais (maiúsculas/minúsculas e caracteres especiais).
• Confirme se está apontando para o servidor e banco corretos.

“Servidor inacessível / tempo esgotado”

• Verifique Host e Porta (3306 MySQL / 5432 PostgreSQL por padrão).
• Confirme rede/VPN e liberação de firewall entre o app e o servidor.
• Aumente o timeout se a rede for instável.

“Banco de dados não encontrado”

• Use o nome exato do database (sem espaços/letras a mais).
• No PostgreSQL, confira também o Schema (geralmente public).

“Certificado inválido (HTTPS/SSL)”

• Se a API/banco usa certificado interno, a TI deve instalar um certificado confiável.
• Quando possível, use endpoints com certificado válido público.

Próximos passos

• Navegue por Bancos & Schemas para ver tabelas, views, índices e afins.
• Abra o Editor SQL para rodar consultas e salvar favoritas.

Próximo capítulo: Navegar Bancos & Schemas