A tela Bancos de Dados cria e administra bancos MariaDB/MySQL e PostgreSQL, no próprio servidor ou em servidores de banco remotos.
Acesse pelo menu Hospedagem > Bancos de Dados.
Como a tela é organizada
Cada servidor de banco aparece num bloco próprio:
- Local: o MariaDB/MySQL ou PostgreSQL instalado neste servidor (pelo Setup, em Configurações).
- Conexões remotas: servidores de banco adicionados por você.
O selo ativo indica que o painel consegue falar com o servidor. Se aparecer parado, inicie o serviço em Servicos. Se aparecer sem conexao, verifique host, credenciais e firewall.
Cada bloco tem duas tabelas: os bancos (Banco, Tabelas, Tamanho, Usuarios com acesso, Dono) e os Usuarios do banco, com os bancos associados a cada um.
Criar um banco
- No bloco do servidor desejado, clique em Novo banco.
- Preencha Nome do banco: letras, números e
_, até 48 caracteres. - Em Dono (conta), escolha a conta de hospedagem. Ajuda a organizar, filtra a lista do staging e faz um banco local entrar no backup daquela conta, mesmo que o nome não comece pelo nome da conta.
- Escolha o Acesso:
- Criar usuario novo;
- Usuario existente;
- So o banco (sem usuário).
- Escolha a permissão: Acesso total ao banco ou Somente leitura.
- Clique em Criar.
Campos de Criar usuario novo:
| Campo | O que informar |
|---|---|
| Usuario | Letras, números e _, até 32 caracteres. Vazio = mesmo nome do banco. |
| Senha | De 8 a 128 caracteres. Vazio = o painel gera uma senha forte. |
| Host de acesso | Só MariaDB/MySQL: % (qualquer host), localhost ou rede interna. |
Para um site no mesmo servidor, use localhost.
Atenção: a senha aparece uma única vez, na mensagem depois de criar. Anote antes de sair da tela.
A senha não pode ter aspas, crase, barra invertida nem caracteres de controle.
Gerenciar usuários do banco
| Ação | Como fazer |
|---|---|
| Criar usuário | Clique em Novo usuario. Informe usuário, senha, host e permissão e, se quiser, marque em Associar aos bancos. |
| Dar acesso a outro banco | Clique em Associar, escolha o banco e a permissão. Se já estiver associado, a permissão é substituída. |
| Tirar o acesso | Clique no x ao lado do nome do banco, na linha do usuário. |
| Trocar senha | Clique no ícone de chave. Vazio = gerar senha forte. |
| Excluir | Clique na lixeira da linha do usuário. |
Atenção: ao trocar a senha, o site que usa esse usuário para de conectar até você atualizar a configuração dele (
app/etc/env.php,.envouwp-config.php).
No PostgreSQL, um usuário que é dono de um banco não pode ser excluído. Apague o banco ou troque o dono antes.
Exportar (dump)
- Na linha do banco, clique em Baixar dump (.sql.gz).
- O arquivo é gerado e baixado em seguida.
O nome segue o padrão banco-AAAAMMDD-HHMM.sql.gz. Bancos grandes podem levar alguns minutos.
Se o dump falhar no meio, o painel mostra o erro em vez de entregar um arquivo vazio ou incompleto.
Importar
- Na linha do banco, clique em Importar SQL.
- Escolha um arquivo
.sqlou.sql.gz. - Clique em Importar.
O arquivo enviado fica numa pasta protegida do servidor enquanto é importado. Se a importação falhar no meio, a mensagem mostra o erro.
Atenção: a importação é aplicada direto no banco. Faça um dump antes se precisar voltar atrás. Uma importação que falhou no meio pode ter aplicado parte do arquivo.
Apagar um banco
- Clique na lixeira da linha do banco.
- Confirme.
Atenção: apagar o banco remove todos os dados, sem volta. O usuário que o painel registrou como principal desse banco também é excluído.
Conectar um servidor de banco remoto
- Clique em Adicionar conexao remota.
- Preencha os campos.
- Clique em Salvar e testar.
| Campo | O que informar |
|---|---|
| Nome (identificacao) | Ex.: DB Producao. |
| Engine | MariaDB/MySQL ou PostgreSQL. |
| Host / IP | Endereço do servidor de banco. |
| Porta | Vazio = 3306 (MariaDB/MySQL) ou 5432 (PostgreSQL). |
| Usuario (admin) | Usuário com permissão administrativa. Vazio = root ou postgres. |
| Senha | Senha desse usuário. |
O painel instala o cliente de banco que faltar e testa a conexão. Se o teste falhar, a conexão fica salva mesmo assim, com o selo sem conexao.
As senhas dos bancos remotos e dos usuários não aparecem na lista de processos do servidor enquanto o painel trabalha com eles.
Dica: a tela não edita uma conexão já salva. Se algum dado estiver errado, remova a conexão e adicione de novo.
Para remover, clique no x do bloco da conexão. Os bancos no servidor remoto não são apagados.
Consultar os dados
Para ver tabelas e rodar SQL, use Navegar Bancos.