Conectar-se ao MySQL

Você pode conectar seus bancos de dados MySQL ao Data Studio usando o conector do MySQL. Use as tabelas de banco de dados ou consultas personalizadas para criar relatórios e painéis interativos. Em seguida, compartilhe esses insights com partes interessadas ou membros da equipe que não têm acesso direto ao banco de dados.

Versões compatíveis

O Data Studio é compatível com as seguintes versões do MySQL:

  • 5.6 (desativação)
  • 5.7 (desativação)
  • 8,0
  • 9,0

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

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 ou a uma consulta personalizada.

Para se conectar ao banco de dados MySQL, siga estas etapas:

  1. Faça login no Data Studio.
  2. Na página inicial do Data Studio, clique em Criar e selecione Fonte de dados.
  3. Selecione o conector do MySQL.
  4. Configure o acesso ao seu banco de dados usando uma das opções de conexão.
  5. Clique em AUTENTICAR. Uma lista de tabelas vai aparecer.
  6. Selecione uma tabela na lista ou insira uma consulta personalizada.
  7. Clique em CONECTAR.

Agora você pode acessar todas as colunas da tabela como campos nos seus relatórios.

Opções de conexão

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

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

Conectar usando SSL

O Data Studio aceita conexões seguras (criptografadas) com o servidor usando o protocolo TLS (Transport Layer Security) (TLS 1.2). O TLS também é chamado de SSL (Secure Socket Layer).

Para ativar uma conexão segura, selecione Ativar SSL e envie seus arquivos de configuração de SSL.

O uso de SSL não é obrigatório pelo Data Studio, mas pode ser necessário para a configuração do banco de dados. Consulte o fornecedor do banco de dados para mais detalhes.

Conectar usando a autenticação de cliente

Quando a caixa Ativar autenticação do cliente está marcada, é possível fazer upload de uma chave privada e de um certificado do cliente, se necessário, para acessar seu banco de dados.

O Data Studio não exige o uso da autenticação de cliente, mas isso pode ser necessário para a configuração do seu banco de dados. Consulte o fornecedor do banco de dados para mais detalhes.

Consulta personalizada

Selecione a opção CONSULTA PERSONALIZADA para estabelecer uma consulta SQL, em vez de se conectar a uma única tabela. O Data 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. Por exemplo, o seguinte 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.

Tipos de dados compatíveis

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, ele não vai criar um campo para ela.

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

Os seguintes endereços são reservados para a infraestrutura global do Data Studio:

  • 142.251.74.0/23

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

Se você ativou a residência de dados na sua assinatura do Data Studio Pro, use os seguintes endereços:

  • 142.251.56.0/24

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

Limites do conector do 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 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.
  • O Data Studio não é compatível com extensões de dados espaciais 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 Data Studio para conferir uma lista de mensagens de erro comuns e as etapas para resolvê-los.

Criar uma fonte de dados