Gerenciar MySQL

O MySQL é um sistema de gerenciamento de banco de dados usado para armazenar e processar dados estruturados. Em um ambiente DBaaS, você recebe um cluster de banco de dados gerenciado sem a necessidade de configuração manual: tudo é tratado automaticamente.

Ao criar um cluster, você pode escolher a versão do MySQL: 8.0 ou 8.4.

Criar bancos de dados

Ao criar um novo cluster, um banco de dados chamado default_db é criado automaticamente.

Você pode criar bancos de dados adicionais:

1. Vá para a seção Bancos de dados no painel de controle da Hostman.
2. Clique no cluster desejado.
3. Na aba Bancos de dados, clique em Adicionar.
4. Informe um nome para o banco de dados (3–64 caracteres, letras, números e caracteres especiais permitidos).
5. Adicione uma descrição, se necessário.
6. Clique em Criar.

Importar banco de dados

Para importar um banco de dados:

1. Vá para a seção Bancos de dados no painel de controle da Hostman.
2. Clique no cluster desejado.
3. Na aba Bancos de dados, clique em Importar.
4. Insira os detalhes de conexão do banco de dados que deseja importar.
5. Clique em Iniciar importação.

Requisitos e limitações

• Acesso à rede: O banco de dados de origem deve ser acessível via internet a partir de qualquer endereço IP. Sem isso, a importação não será iniciada.
• Nome único: O cluster de destino não pode conter um banco de dados com o mesmo nome.

O que será transferido:

• Estruturas de tabelas
• Dados nas tabelas

O que não será transferido:

• Usuários. Você precisará criar os usuários manualmente no novo banco após a importação.

Antes de executar a importação, recomendamos reduzir temporariamente o parâmetro innodb_buffer_pool_size para 50% da RAM alocada ao banco de dados.

Usuários e privilégios

No painel de controle, você pode gerenciar os usuários do MySQL e seus privilégios.

Criar usuários

1. Vá para a seção Bancos de dados e clique no cluster.
2. Abra a aba Usuários e clique em Adicionar.
3. Defina o nome de usuário e senha:
   • Nome de usuário: 3–32 caracteres (letras, números e caracteres especiais permitidos)
   • Senha: 8–30 caracteres (letras, números e caracteres especiais permitidos)
4. (Opcional) Configure os privilégios do usuário. Você também pode deixar os parâmetros padrão e alterá-los depois a qualquer momento.
5. Clique em Criar.

Modificar privilégios

Para atualizar os privilégios de um usuário existente:

1. Vá para a seção Bancos de dados e clique no cluster.
2. Abra a aba Usuários.
3. Clique nos três pontos ao lado do usuário.
4. Selecione Privilégios.
5. Escolha os privilégios necessários. Você pode conceder acesso a um banco específico ou habilitar Idêntico para todos os bancos de dados no canto superior direito para aplicar os mesmos privilégios a todos os bancos.

Privilégios disponíveis

Alterar senha de usuário

Para alterar a senha de um usuário:

1. Vá para a seção Bancos de dados e clique no cluster.
2. Abra a aba Usuários.
3. Clique nos três pontos ao lado do usuário.
4. Selecione Alterar senha.
5. Digite o novo valor e salve as alterações.

Parâmetros do banco de dados

Você pode alterar as configurações do banco de dados para otimizar seu desempenho.

Por padrão, o banco de dados é criado com parâmetros adequados para a maioria das tarefas e que garantem o desempenho da configuração selecionada. No entanto, se seu projeto exigir configurações específicas, você pode alterá-las conforme desejar.

Atenção: altere os parâmetros apenas se tiver certeza de seu propósito. Configurações incorretas podem afetar negativamente o funcionamento do banco de dados e seu desempenho.

Configurar parâmetros

1. Vá para a seção Bancos de dados e clique no cluster.
2. Acesse a aba Configuração.
3. Clique em Modificar parâmetros ao lado de Parâmetros do banco de dados.
4. Ajuste os parâmetros. Para saber mais sobre cada um, clique em Abrir descrição ao lado do parâmetro.
5. Clique em Aplicar no final da página.

Os parâmetros disponíveis dependem da versão do MySQL selecionada.

Lista de parâmetros

Restaurar parâmetros padrão

Você pode restaurar os parâmetros padrão facilmente:

1. Vá para a seção Bancos de dados e clique no cluster.
2. Acesse a aba Configuração.
3. Clique em Modificar parâmetros ao lado de Parâmetros do banco de dados.
4. Role até o final da página e clique em Restaurar configurações padrão.

Atenção: os parâmetros serão restaurados imediatamente, sem confirmação adicional.

Conectar ao banco de dados

Você pode se conectar aos bancos de dados via interface web ou terminal. A conexão via web é possível apenas se o cluster tiver um IP público.

Adminer e phpMyAdmin

Você pode se conectar ao banco via interfaces web integradas: Adminer ou phpMyAdmin.

1. Vá para a seção Bancos de dados e clique no cluster.
2. Clique no botão Interface web e selecione a opção desejada.

Terminal

Instale o cliente MySQL:

• Ubuntu: 

sudo apt install mysql-client

• Debian: 

sudo apt install mariadb-client

• Arch: 

sudo pacman -S percona-server-clients

• Fedora: 

sudo dnf install mysql

Existem duas formas de conectar-se a um cluster MySQL:

• via IP público
• via IP privado

Você pode copiar o comando de conexão a partir da aba Dashboard ou Conexão.

Se estiver usando MariaDB 10.10 ou superior como cliente, utilize a opção --skip_ssl ao se conectar ao cluster.

Criar dump

Para criar um dump, execute:

mysqldump --set-gtid-purged=off -y -u gen_user -p'password' -h ip_dbaas default_db | gzip > default_db.sql.gz

Explicação:

• --set-gtid-purged=off exclui o comando SET @@GLOBAL.GTID_PURGED, evitando erros caso os privilégios sejam insuficientes
• -y (--no-tablespaces) exclui tablespaces, prevenindo possíveis erros na criação do dump

Importar dump

Para importar um dump, execute:

cat default_db.sql.gz | gzip -d | mysql -u gen_user -p'password' -h ip_dbaas default_db

Este comando descomprime o dump e envia para execução pelo cliente MySQL.

Limitações do plano básico

O plano básico de banco de dados (1 CPU / 1 GB de RAM / 20 GB NVMe) possui as seguintes limitações técnicas:

• Não é possível adicionar bancos de dados adicionais
• Não é possível adicionar usuários adicionais
• Não é possível configurar os seguintes parâmetros:
  • innodb_buffer_pool_size
  • sort_buffer_size
  • max_connections
  • join_buffer_size
  • thread_cache_size