Conectar-se ao MySQL

Com o conector do MySQL, é possível acessar dados dos bancos de dados MySQL no Looker Studio.

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 é baseado 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 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.

Para conectar

Etapa 1

Faça login no Looker Studio.

Etapa 2

Na parte de cima à esquerda da página inicial do Looker Studio, clique em Criar e selecione Fonte de dados.

Etapa 3

Selecione o conector MySQL.

Etapa 4

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

Conectar-se usando um nome de 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. Por exemplo: jdbc: mysql ://[2001:db8:1:1:1:1:1:1]/your_db

Etapa 5

Ativar SSL

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 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 Looker 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 a 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 Looker 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. O Looker Studio usa esse SQL personalizado como uma instrução SELECT interna 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 Looker 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 vai aparecer. Clique em CRIAR RELATÓRIO para começar a visualizar seus dados.

Observações

Tipos de dados

O Looker Studio mapeia os tipos de dados integrados do seu banco de dados para 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 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 aceitos.

Solução de problemas

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

Criar uma origem de dados