Conectar-se ao MySQL

O conector do MySQL permite acessar os dados dos bancos MySQL no Data Studio.

Como se conectar ao MySQL

Uma fonte de dados do Data Studio pode se conectar a uma única tabela de banco de dados do MySQL.

O conector do Data Studio MySQL é feito com base no Google Cloud SQL para MySQL e está sujeito aos mesmos limites das versões e recursos compatíveis. Saiba mais sobre o Google Cloud SQL para MySQL.

Versões compatíveis

Testamos o Data Studio nas seguintes versões do MySQL:

  • 5,6
  • 5,7
  • 8,0

Se você tiver problemas ao usar uma versão compatível, deixe um comentário na Comunidade do Data Studio. Também é possível adicionar e votar em solicitações de recursos no Issue Tracker.

Como conectar

Etapa 1

Faça login no Data Studio.

Etapa 2

Na página inicial do Data Studio, no canto superior esquerdo, clique em Criar e selecione Fonte de dados.

Etapa 3

Selecione o conector do MySQL.

Etapa 4

Configure a conexão com o banco de dados usando um nome do host ou endereço IP ou um URL JDBC.

Conectar usando um nome do host ou endereço IP

Na conexão, selecione BÁSICO . Digite os detalhes da conexão:

  • Nome do host ou endereço IP
  • Porta (opcional)
  • Banco de dados
  • Nome de usuário
  • Senha

Conectar usando um URL JDBC

Na conexão, selecione URL JDBC . Digite os detalhes da conexão:

  • URL JDBC

    • Exemplo jdbc:mysql://HOSTNAME[:PORT];databaseName=DATABASE

  • Nome de usuário
  • Senha

Se você usa a opção de nome do host JDBC, pode verificar se ele é acessível com ferramentas de busca DNS público, como o Whois.

Para se conectar usando um endereço literal IPv6, inclua o endereço entre colchetes. Exemplo: jdbc: mysql ://[2001:db8:1:1:1:1:1:1]/your_db

Etapa 5

Ativar SSL

O Data Studio aceita conexões seguras (criptografadas) com o servidor usando o protocolo TLS (Transport Layer Security). O TLS também é conhecido como SSL (Secure Sockets Layer). Para ativar uma conexão segura, marque a opção Ativar SSL e envie seus arquivos de configuração de SSL.

Essa configuração não é obrigatória para o Data Studio, mas pode ser necessária para a configuração do banco de dados. Consulte o fornecedor do banco de dados para mais detalhes.

Etapa 6

Ativar autenticação do cliente

Se essa caixa for marcada, você poderá fazer upload de uma chave privada e de um certificado do cliente, se necessário, para acessar seu banco de dados.

Essa configuração não é obrigatória para o Data Studio, mas pode ser necessária para a configuração do banco de dados. Consulte o fornecedor do banco de dados para mais detalhes.

Etapa 7

Clique em AUTENTICAR.

Etapa 8

Selecione uma tabela na lista ou insira uma consulta personalizada.

Selecione a opção CONSULTA PERSONALIZADA para estabelecer uma consulta SQL, em vez de se conectar a uma única tabela. Esse SQL personalizado é usado como uma instrução SELECT interna no Data Studio a cada consulta gerada para o banco de dados.

O exemplo a seguir não funciona porque tem várias instruções SQL:


DECLARE cost_per_tb_in_dollar FLOAT64 DEFAULT 4.2;

SELECT total_bytes_billed / (1024 * 1024))* cost_per_tb_in_dollar)/(1024*1024))) FROM billing-table;

As consultas no Data Studio podem atingir o tempo limite após três a cinco minutos. Se as consultas personalizadas expirarem, tente as seguintes abordagens para resolver o problema:

  • Simplifique a consulta para que seja executada com mais rapidez.
  • Execute a consulta no seu banco de dados e armazene os resultados em uma tabela separada. Conecte a nova tabela na sua fonte de dados.

Etapa 9

Clique em CONECTAR.

Em instantes, a página da lista de campos da fonte de dados será exibida. Clique em CRIAR RELATÓRIO para começar a visualizar seus dados.

Observações

Tipos de dados

O Data Studio mapeia os tipos de dados integrados do seu banco de dados para um conjunto unificado de tipos de dados. Se o Data Studio encontrar uma coluna não compatível na tabela ou consulta, a API não criará um campo para ela.

Observação : o Data Studio não é compatível com extensões de dados espaciais do MySQL.

Firewall e acesso ao banco de dados

Para permitir que o Data Studio se conecte e consulte bancos de dados protegidos por firewall, abra o acesso a um dos seguintes endereços IP. Talvez também seja necessário configurar seu banco de dados para aceitar tráfego desses endereços. Consulte a documentação do seu banco de dados específico para saber como fazer isso.

Endereços IP

  • 142.251.74.0/23

  • 2001:4860:4807::/48 (opcional para plataformas com suporte a IPv6)

Limites do conector do MySQL

  • Esse conector permite adicionar até 150 mil linhas por consulta. Se você exceder esse limite, os dados serão truncados.
  • Os cabeçalhos das colunas (nomes dos campos) só aceitam caracteres ASCII. Caracteres não ASCII não são compatíveis.

Solução de problemas

Consulte o guia de solução de problemas do Data Studio para conferir uma lista de mensagens de erro comuns e as etapas para resolvê-los.

Criar uma fonte de dados