Ligue-se ao MySQL

O conetor do MySQL permite-lhe aceder a dados das bases de dados do MySQL no Data Studio.

Como fazer a ligação ao MySQL

Uma origem de dados do Data Studio pode ligar-se a uma única tabela de base de dados do MySQL.

O conetor do MySQL do Data Studio baseia-se no Google Cloud SQL para MySQL e está sujeito aos mesmos limites nas versões e nas funcionalidades compatíveis. Saiba mais acerca do Google Cloud SQL para MySQL.

Versões compatíveis

Testámos o Data Studio nas seguintes versões do MySQL:

  • 5.6
  • 5.7
  • 8.0

Se tiver problemas com a utilização de uma versão compatível, informe-nos na Comunidade do Data Studio. Também pode adicionar e votar em pedidos de funcionalidades no Issue Tracker.

Para fazer a ligação

Passo 1

Inicie sessão no Data Studio.

Passo 2

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

Passo 3

Selecione o conetor do MySQL.

Passo 4

Configure a ligação à sua base de dados através de um nome de anfitrião ou um endereço IP, ou um URL JDBC.

Faça a ligação através de um nome de anfitrião ou um endereço IP

Na ligação, selecione BÁSICO . Introduza os detalhes da ligação:

  • Nome de anfitrião ou endereço IP
  • Porta (opcional)
  • Bases de dados
  • Nome de utilizador
  • Palavra-passe

Faça a ligação através de um URL JDBC

Na ligação, selecione URL JDBC . Introduza os detalhes da ligação:

  • URL JDBC

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

  • Nome de utilizador
  • Palavra-passe

Se usar a opção de nome de anfitrião JDBC, pode certificar-se de que está acessível com ferramentas de pesquisa de DNS públicas, como o Whois.

Para fazer a ligação através de um endereço literal IPv6, inclua o endereço entre parênteses retos. Por exemplo: jdbc: mysql ://[2001:db8:1:1:1:1:1:1]/your_db

Passo 5

Ative o SSL

O Data Studio é compatível com ligações seguras (encriptadas) ao servidor através do protocolo TLS (Transport Layer Security). O TLS também é designado SSL (Secure Sockets Layer). Para ativar uma ligação segura, selecione Ativar SSL e, de seguida, indique os ficheiros de configuração SSL.

Esta definição não é obrigatória para o Data Studio, mas pode ser necessária para a configuração da sua base de dados. Contacte o fornecedor da base de dados para saber mais detalhes.

Passo 6

Ative a autenticação do cliente

Quando esta caixa está selecionada, pode carregar uma chave privada do cliente e um certificado do cliente, se forem necessários para aceder à sua base de dados.

Esta definição não é obrigatória para o Data Studio, mas pode ser necessária para a configuração da sua base de dados. Contacte o fornecedor da base de dados para saber mais detalhes.

Passo 7

Clique em AUTENTICAR.

Passo 8

Selecione uma tabela na lista ou introduza uma consulta personalizada.

Selecione a opção CONSULTA PERSONALIZADA para indicar uma consulta SQL em vez de se ligar a uma única tabela. O Data Studio usa este SQL personalizado como uma instrução de seleção interna para cada consulta gerada à base de dados.

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 limite de tempo após três a cinco minutos. Se as suas consultas personalizadas atingirem o limite de tempo, experimente as seguintes abordagens para resolver o problema:

  • Simplifique a consulta para que seja executada mais rapidamente.
  • Execute a consulta na sua base de dados e armazene os resultados numa tabela separada. Ligue a nova tabela na sua origem de dados.

Passo 9

Clique em LIGAR.

Em breve, é apresentada a página da lista de campos da origem de dados. Clique em CRIAR RELATÓRIO para começar a visualizar os seus dados.

Notas

Tipos de dados

O Data Studio mapeia os tipos de dados incorporados da sua base de dados para um conjunto unificado de tipos de dados. Se o Data Studio encontrar uma coluna na sua tabela ou consulta de um tipo não compatível, não cria um campo para essa coluna.

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

Firewall e acesso à base de dados

Para permitir que o Data Studio se ligue a bases de dados protegidas por uma firewall e as consulte, tem de abrir o acesso a um dos seguintes endereços IP. Também pode ter de configurar a sua base de dados para aceitar tráfego destes endereços. Consulte a documentação da sua base de dados específica para ver instruções sobre como o fazer.

Endereços IP

  • 142.251.74.0/23

  • 2001:4860:4807::/48 (Opcional, para plataformas compatíveis com IPv6)

Limites do conetor do MySQL

  • Pode consultar um máximo de 150 mil linhas por consulta através deste conetor. Se exceder este limite, os dados são truncados.
  • Os cabeçalhos das colunas (nomes dos campos) só podem usar carateres ASCII. Os carateres não ASCII não são compatíveis.

Resolução de problemas

Consulte o guia de resolução de problemas do Data Studio para ver uma lista de mensagens de erro comuns e os passos para as resolver.

Crie uma origem de dados