Conectar-se ao MySQL

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

Neste artigo:

• Como se conectar ao MySQL
• Observações
• Limites
• Recursos relacionados

Como se conectar ao MySQL

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

O conector do Looker Studio MySQL tem como base o 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 Looker 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 de Ajuda do Looker Studio. É possível adicionar e votar nas solicitações de recursos aqui.

Como conectar

1. Faça login no Looker Studio.
2. No canto superior esquerdo da página inicial do Looker Studio, clique em Criar e selecione Fonte de dados.
3. Selecione o conector do MySQL.
4. Configure a conexão ao seu banco de dados:

   Conectar-se com um nome do host ou endereço IP

   1. À esquerda, selecione BÁSICO.
   2. Digite os detalhes da conexão:
      1. Nome do host ou endereço IP
      2. Porta (opcional)
      3. Banco de dados
      4. Nome de usuário
      5. Senha

   Conectar-se com um URL JDBC

   1. À esquerda, selecione URL JDBC.
   2. Digite os detalhes da conexão:
      1. URL JDBC

         Exemplo
         
         jdbc:mysql://<nome do host ou endereço IP>[:<porta>]/<banco de dados>

      2. Nome de usuário
      3. 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. Por exemplo: jdbc:mysql://[2001:db8:1:1:1:1:1:1]/your_db

   Para mais informações, consulte https://datatracker.ietf.org/doc/html/rfc2732 (link em inglês).
   Observação: não é possível conectar o Looker Studio ao localhost. Use um nome do host ou endereço IP público.

5. Ativar SSL (opcional)

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

6. Ativar a autenticação do cliente (opcional)

   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.

7. Clique em AUTENTICAR.
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. O Looker Studio usa esse SQL personalizado como uma instrução SELECT interna a cada consulta gerada para o banco de dados.

   As consultas SQL personalizadas só podem ter uma instrução.

   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;

   Observação: as consultas no Looker Studio podem atingir o tempo limite após 3 a 5 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-se a essa tabela na sua fonte de dados.
9. Clique em CONECTAR.

Em instantes, a página da lista de campos da fonte de dados será exibida. No canto superior direito, clique em CRIAR RELATÓRIO ou EXPLORAR para começar a visualizar seus dados.

Observações

Tipos de dados

O Looker Studio corresponde os tipos nativos do seu banco de dados a um conjunto unificado de tipos de dados. Se o Looker Studio encontrar uma coluna não compatível na tabela ou consulta, ele não vai criar um campo para ela.

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

Firewall e acesso ao banco de dados

Para permitir que o Looker Studio se conecte e consulte bancos de dados protegidos por firewall, abra o acesso a endereços IP específicos. 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.

Alerta: os endereços IP atualmente usados pelo Looker Studio para se conectar aos seus bancos de dados vão mudar no início de 2023. Para garantir que seus relatórios continuem funcionando corretamente depois da alteração, você precisará abrir os endereços IP listados abaixo.

Mostrar a lista de endereços IP

142.251.74.0/23 
2001:4860:4807::/48 (opcional, para plataformas compatíveis com IPv6)
74.125.0.0/16

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.

Recursos relacionados

Criar uma fonte de dados