Documentação ServBay: Gerenciando Bancos de Dados com o Adminer

Visão Geral

O ServBay é um ambiente de desenvolvimento web local robusto projetado especialmente para macOS, integrando diversos servidores web, runtimes de linguagens e sistemas de banco de dados. Para facilitar o gerenciamento destas bases de dados internas, o ServBay vem pré-instalado e configurado com o Adminer, uma ferramenta poderosa e leve para gerenciamento de bancos de dados. Este documento irá guiá-lo sobre como conectar e administrar bancos de dados incluídos no ServBay utilizando o Adminer.

O que é o Adminer

O Adminer é um gerenciador de banco de dados portátil escrito em PHP, composto por um único arquivo, com suporte a diversos sistemas como MySQL, MariaDB, PostgreSQL, SQLite, MongoDB e mais. Em comparação com clientes de banco de dados mais pesados, o Adminer oferece vantagens notáveis:

1. Leve e de fácil implantação: Com apenas um arquivo PHP, o Adminer não requer instalação complexa, sendo simples de implantar e usar. O ServBay já integra essa ferramenta pronta para uso.
2. Suporte a múltiplos bancos de dados: Permite conectar e gerenciar diferentes tipos de banco de dados por uma interface unificada, eliminando a necessidade de instalar ou aprender diversas ferramentas.
3. Interface limpa e intuitiva: Oferece um ambiente visual amigável e direto, facilitando o aprendizado mesmo para quem está utilizando pela primeira vez.
4. Funcionalidade completa: Suporta operações amplamente utilizadas como criar, modificar e excluir bancos, tabelas, índices e usuários, executar comandos SQL, importar/exportar dados, entre outros.

Para desenvolvedores que usam o ServBay em desenvolvimento local, o Adminer se destaca como uma solução prática e eficiente para administrar bancos de dados.

Acessando o Adminer

Após iniciar o ServBay, o Adminer é executado automaticamente e fica acessível via o servidor web integrado. Basta acessar o endereço local padrão do ServBay, complementando com o nome do arquivo Adminer:

https://servbay.host/adminer.php

Certifique-se de que o aplicativo ServBay esteja em funcionamento, assim como o servidor web relevante (Caddy ou Nginx, por exemplo) e o serviço de banco de dados que deseja acessar.

Conectando-se aos Bancos de Dados no ServBay

A tela de login do Adminer é extremamente intuitiva. Você deve selecionar o tipo do banco de dados e fornecer o endereço do servidor, usuário, senha e, em certos casos, o nome do banco de dados. O ServBay gera automaticamente usuários e senhas padrão para bancos integrados – essas informações estão na aba "Banco de Dados" do aplicativo ServBay.

Conectando ao MariaDB / MySQL

O ServBay normalmente inclui MariaDB ou MySQL por padrão. No Adminer, basta selecionar o tipo "MySQL" para conectar-se.

1. Abra o navegador e acesse o Adminer (https://servbay.host/adminer.php).
2. Na tela de login, em Sistema, escolha MySQL.
3. Insira as informações de conexão:
   • Servidor: Digite localhost ou use o caminho do Unix Socket fornecido pelo ServBay: /Applications/ServBay/tmp/mysql.sock. A conexão via socket tende a ser mais eficiente.
   • Nome de usuário: Consulte a aba "Banco de Dados" do ServBay para pegar o usuário do MariaDB/MySQL.
   • Senha: Consulte a aba "Banco de Dados" do ServBay para pegar a senha do MariaDB/MySQL.
   • Banco de dados: (Opcional) Caso queira conectar-se diretamente a uma base específica, insira o nome aqui. Deixando em branco, você acessará o servidor e poderá gerenciar todos os bancos após o login.
4. Clique em Login.

Conectando ao PostgreSQL

O ServBay também oferece suporte ao PostgreSQL. No Adminer, selecione o tipo "PostgreSQL".

1. Abra o navegador e acesse o Adminer (https://servbay.host/adminer.php).
2. Em Sistema, escolha PostgreSQL.
3. Preencha as informações de conexão:
   • Servidor: Digite /Applications/ServBay/tmp.
   • Nome de usuário: Consulte o usuário do PostgreSQL na aba "Banco de Dados" do ServBay.
   • Senha: Consulte a senha do PostgreSQL na aba "Banco de Dados" do ServBay.
   • Banco de dados: Insira o nome do banco desejado, como a base padrão postgres ou outro criado por você.
4. Clique em Login.

Conectando ao SQLite 3

O ServBay suporta bancos SQLite 3. Neste caso, o banco é um arquivo, e você deve indicar o caminho até ele.

1. Abra o navegador e acesse o Adminer (https://servbay.host/adminer.php).
2. Em Sistema, escolha SQLite 3.
3. Insira o caminho do arquivo do banco de dados:
   • Arquivo do banco de dados: Digite o caminho completo para o arquivo do SQLite. Recomenda-se armazená-los na pasta de dados do ServBay, como /Applications/ServBay/db/sqlite/your_database_name.sqlite.
   • Caso o arquivo não exista, o Adminer perguntará se deseja criá-lo.
4. Clique em Login.

Executando Operações Comuns no Banco de Dados

Após acessar o servidor de banco de dados ou uma base específica, a interface do Adminer permite realizar diversas tarefas administrativas. As funcionalidades e layout podem variar levemente conforme o tipo de banco, mas os processos básicos permanecem semelhantes.

Criando um Banco de Dados

(Para MariaDB/MySQL e PostgreSQL)

1. Acesse o servidor de banco de dados (sem apontar para uma base específica).
2. No menu à esquerda ou na página principal, localize a opção Criar banco de dados ou similar.
3. Insira o nome desejado para o novo banco.
4. Escolha o conjunto de caracteres e a ordenação, se necessário.
5. Clique em Salvar ou Criar.

(Para SQLite 3, a criação ocorre no login ao informar o caminho de um arquivo inexistente).

Gerenciando Tabelas e Dados

1. Selecione um banco de dados (caso não o tenha feito no login).
2. Na visualização do banco, localize e clique em Criar tabela.
3. Informe o nome da tabela e defina os campos (colunas), especificando nome, tipo de dado, tamanho, se aceita NULL, valor padrão, índices (chave primária, única, comum) etc.
4. Clique em Salvar para criar a tabela.
5. Após criada, escolha a tabela pelo menu lateral ou resumo.
6. Realize as operações sobre os dados:
   • Inserir: Adicione novas linhas de dados.
   • Selecionar: Visualize, pesquise, ordene e filtre registros.
   • Atualizar: Edite registros existentes.
   • Excluir: Remova registros.
   • Utilize Comando SQL para consultas ou operações mais avançadas.

Executando Comandos SQL

O Adminer oferece um campo próprio para inserção e execução direta de comandos SQL, permitindo administração e consultas com flexibilidade.

1. Escolha a base de dados onde será executado o comando.
2. Acesse a opção Comando SQL.
3. No campo de texto, insira seu comando SQL.
4. Clique em Executar.

Importando e Exportando Dados

O Adminer possibilita exportar estrutura e dados para arquivos SQL ou CSV, assim como importar estes formatos – útil para migração, backup ou compartilhamento de dados.

1. Escolha o banco de dados ou tabela a ser importado/exportado.
2. Procure pelas opções Exportar ou Importar.
3. Siga as instruções na tela para escolher formato, opções e concluir o procedimento.

Excluindo um Banco de Dados

(Para MariaDB/MySQL e PostgreSQL)

1. Entre no servidor de bancos (sem indicar base específica).
2. Na lista, selecione o banco a ser removido.
3. Clique no comando Excluir e confirme. Atenção: esta ação é irreversível e elimina todos os dados do banco.

(Para SQLite 3, a exclusão é feita manualmente apagando o arquivo .sqlite pelo sistema operacional).

Dicas e Cuidados

• Segurança das credenciais: Os usuários e senhas gerados pelo ServBay para bancos de dados devem ser mantidos em segredo.
• Estado de execução do ServBay: O Adminer funciona através do web server integrado do ServBay e requer os serviços de banco em execução. Problemas de acesso normalmente estão ligados ao status do app ou dos pacotes (Caddy/Nginx, MariaDB/MySQL, PostgreSQL etc).
• Caminho de arquivos SQLite: Certifique-se de apontar os bancos SQLite para diretórios onde o usuário do ServBay tenha permissão de leitura/escrita. O caminho recomendado é /Applications/ServBay/db/sqlite/.
• Desempenho: O Adminer é uma ferramenta leve. Para bancos muito grandes ou tarefas complexas, considere clientes desktop especializados, como TablePlus, DBeaver, pgAdmin, entre outros.

Perguntas Frequentes (FAQ)

Q: Não consigo acessar https://servbay.host/adminer.php. O que fazer?

A: Verifique se o ServBay está em execução, assim como o seu servidor web (geralmente Caddy ou Nginx). Confirme também se o navegador permite acesso a https://servbay.host.

Q: Esqueci o usuário ou a senha do banco. Onde encontro essas informações?

A: Você encontra os usuários e senhas padrão gerados pelo ServBay na aba "Banco de Dados" da interface do aplicativo.

Q: Quais são o endereço e a porta do servidor ao conectar no PostgreSQL?

A: O endereço geralmente é localhost e a porta padrão é 5432. Consulte as configurações do ServBay para conferir a porta e endereço do PostgreSQL. Para conexão via Unix Domain Socket, informe /Applications/ServBay/tmp (lembrando que não é necessário incluir .sock para PostgreSQL).

Q: Qual a diferença entre endereço do servidor e caminho do socket ao conectar no MariaDB/MySQL?

A: localhost conecta via TCP/IP (porta 3306 por padrão), enquanto /Applications/ServBay/tmp/mysql.sock utiliza conexão via Unix Domain Socket. Em ambientes locais, o socket costuma ser mais rápido e seguro. Escolha o método que preferir.

Q: Posso gerenciar outros bancos (não integrados ao ServBay) pelo Adminer?

A: O Adminer suporta diversos bancos. Se você possui outros sistemas instalados fora do ServBay (como um MongoDB independente ou um banco remoto), é possível conectá-los desde que a rede seja acessível e você possua as credenciais corretas. Porém, a principal vantagem do Adminer integrado ao ServBay é facilitar o gerenciamento dos bancos locais disponibilizados por ele.

Conclusão

O Adminer, integrado ao ServBay, é uma ferramenta extremamente prática para administrar bancos de dados. Seu formato leve, de único arquivo, com suporte a diversos sistemas, torna muito mais simples gerenciar MariaDB/MySQL, PostgreSQL e SQLite em ambientes de desenvolvimento local. Com as orientações deste guia, você poderá conectar-se facilmente aos bancos do ServBay e realizar as tarefas diárias de administração e manipulação de dados com confiança.