Skip to main content

Como conectar ao MySQL

Como conectar a sua instância MySQL a partir de uma Máquina Virtual (Jumphost)​

Para conectar-se ao banco de dados MySQL, é necessário uma Virtual Machine (máquina virtual) provisionada na mesma região do banco de dados a que deseja-se conectar.

Vamos assumir que você já tenha uma instância de VM com sistema Ubuntu rodando e acessível via SSH. Caso não tenha, crie uma nova Máquina Virtual.

  1. Conecte na sua VM utilizando SSH.

  2. Uma vez dentro do jumphost (VM Ubuntu), você pode instalar o cliente mysql. Caso já possua, pule para o próximo passo:

    a. Atualizar a sua VM com o comando:

    sudo apt update

    b. Instalar o mysql-client (CLI):

    sudo apt install mysql-client

  3. Utilizar a CLI mysql para realizar a conexão com com o banco de dados:

    mysql -h ip_privado_do_banco -u usuario -p
    • Substitua “ip_privado_do_banco” pelo IP privado do banco na mesma região da VM.
    • Substitua ‘usuário’ pelo nome de usuário do banco de dados MySQL que você informou ao criar a instância do banco.

  4. Após executar este comando com sucesso, em "Enter Password", informe a senha que você forneceu ao criar a instância do banco de dados.

Pronto. Se tudo deu certo, você está conectado na sua instância MySQL.

Como conectar a sua instância MySQL diretamente da sua máquina local​

Para conectar-se ao banco de dados diretamente da sua máquina local, você precisa garantir que sua máquina tenha acesso à rede onde o banco de dados está hospedado. Para isso você pode utilizar o tunelamento SSH através de uma Máquina Virtual (Jumphost) na mesma região do banco de dados.

  1. Primeiro, você precisa criar um túnel SSH da sua máquina local para a Máquina Virtual (Jumphost) que está na mesma região do banco de dados MySQL. Execute o seguinte comando no terminal da sua máquina local:

    ssh -L 3306:ip_privado_do_banco:3306 usuario_da_vm@endereco_ip_da_vm
    • Substitua ip_privado_do_banco pelo IP privado do banco na mesma região da VM.
    • Substitua usuario_da_vm pelo nome de usuário da Máquina Virtual. Caso sua VM tenha o sistema Ubuntu, o usuário padrão geralmente é ubuntu.
    • Substitua endereco_ip_da_vm pelo endereço IP público da Máquina Virtual.

    Este comando cria um túnel que redireciona o tráfego da porta 3306 (porta padrão do MySQL) da sua máquina local para a porta 3306 do banco de dados através da Máquina Virtual.

  2. Mantenha o terminal aberto para que o túnel SSH permaneça ativo.

  3. Agora, em outro terminal na sua máquina local, você pode usar o cliente mysql para conectar-se ao banco de dados MySQL através do túnel SSH:

    mysql -h localhost -u "usuario" -p
    • Substitua usuario pelo nome de usuário do banco de dados MySQL que você informou ao criar a instância do banco.

    Após executar este comando com sucesso, será solicitado que você informe a senha que forneceu ao criar a instância do banco de dados.

Como conectar a sua instância MySQL utilizando uma ferramenta gráfica (GUI)​

Para conectar-se ao banco de dados MySQL utilizando DBeaver ou Beekeeper Studio, você pode seguir os passos abaixo:

  1. Abra a ferramenta gráfica de sua preferência (DBeaver ou Beekeeper Studio).
  2. Crie uma nova conexão de banco de dados e selecione MySQL como o tipo de banco de dados.
  3. Preencha os campos de conexão com as seguintes informações:
    • Host: IP privado do banco de dados (na mesma região da VM).
    • Porta: 3306 (porta padrão do MySQL).
    • Database: mysql (ou outro banco de dados que você tenha criado).
    • Username: nome de usuário do banco de dados MySQL que você informou ao criar a instância do banco.
    • Password: senha que você forneceu ao criar a instância do banco.
    • SSH Tunnel: Ative a opção de túnel SSH e preencha os campos com as informações da Máquina Virtual (Jumphost):
      • Host: Endereço IP público da Máquina Virtual.
      • Porta: 22 (porta padrão do SSH).
      • Username: nome de usuário da Máquina Virtual (geralmente ubuntu para VMs com sistema Ubuntu).
      • Authentication Method: Escolha o método chave privada e forneça o caminho para a chave privada SSH que você utiliza para acessar a Máquina Virtual.
    • Port Forwarding: Configure o encaminhamento de porta local para redirecionar a porta 3306 da sua máquina local para a porta 3306 do banco de dados através da Máquina Virtual:
      • Local Port: 3306
      • Remote Host: IP privado do banco de dados
      • Remote Port: 3306
  4. Salve as configurações e teste a conexão.

Referências: