Estabeleça ligação ao Google Cloud SQL para MySQL

O Cloud SQL para MySQL é um serviço de base de dados totalmente gerido que facilita a configuração, a manutenção, a gestão e a administração das suas bases de dados relacionais MySQL no Google Cloud. O conetor do Cloud SQL para MySQL permite-lhe aceder a dados das bases de dados do Cloud SQL para MySQL no Looker Studio.

Versões suportadas

O conetor do Cloud SQL para MySQL foi testado nas seguintes versões do MySQL:

  • 5,6
  • 5.7
  • 8.0

Se tiver problemas ao usar uma versão suportada, informe-nos na Comunidade de ajuda do Looker Studio. Pode adicionar e votar em pedidos de funcionalidades no rastreador de problemas.

Como estabelecer ligação ao Cloud SQL para MySQL

Uma origem de dados do Looker Studio pode estabelecer ligação a uma única tabela de base de dados do Cloud SQL para MySQL ou a uma consulta personalizada que fornecer.

Para associar

  1. Inicie sessão no Looker Studio.
  2. Na página inicial do Looker Studio, na parte superior esquerda, clique em O ícone Criar. Criar e, de seguida, selecione Origem de dados.
  3. Selecione o conetor Cloud SQL para MySQL.
  4. Se lhe for pedido, autorize o Looker Studio a aceder aos seus dados.

  5. Configure a ligação à sua base de dados:

    • Para estabelecer ligação com um nome de anfitrião ou um endereço IP
      1. No lado esquerdo, selecione BÁSICO .
      2. Introduza os detalhes da associação:
        1. Nome da ligação da instância (veja abaixo como listar as ligações de instâncias).
        2. Bases de dados
        3. Nome de utilizador
        4. Palavra-passe
    • Para estabelecer ligação com um URL JDBC
      1. No lado esquerdo, selecione URL JDBC .
      2. Introduza os detalhes da associação:
        1. URL JDBC

          Exemplo jdbc:google:mysql: //<instance connection name>/

        2. Nome de utilizador
        3. Palavra-passe
      > Se usar a opção de nome do anfitrião JDBC, pode certificar-se de que está acessível com ferramentas de procura de DNS público, como o Whois.
    Para estabelecer ligação através de um endereço literal IPv6, coloque o endereço entre parênteses retos. Por exemplo: jdbc:google:mysql://\[2001:db8:1:1:1:1:1:1\]/your_db
    • Nota : o Looker Studio não se consegue ligar ao localhost. Tem de usar um nome de anfitrião público ou um endereço IP.

  6. Clique em AUTENTICAR.

  7. Selecione uma tabela na lista ou introduza uma consulta personalizada.

Selecione a opção CONSULTA PERSONALIZADA para fornecer uma consulta SQL em vez de estabelecer ligação a uma única tabela. O Looker Studio usa este SQL personalizado como uma declaração de seleção interna para cada consulta gerada à base de dados.

Por exemplo, o seguinte não funciona porque tem várias declaraçõ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 limite de tempo após três a cinco minutos. Se as suas consultas personalizadas excederem 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. Associe a nova tabela na sua origem de dados.
  1. Clique em ASSOCIAR.

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

Notas

Encontre o nome da ligação da instância

O nome da ligação da instância identifica a sua instância no Google Cloud. Pode obtê-lo na Google Cloud consola ou através da linha de comandos.

Use a consola

  1. Aceda a https://console.cloud.google.com/sql/instances
  2. Clique no ID da instância ao qual quer estabelecer ligação.
  3. No lado esquerdo, encontra o nome da ligação na secção "Estabelecer ligação a esta instância".

Use a linha de comandos

Para encontrar o nome da ligação através da interface de linhas de comando do Google Cloud, use o seguinte comando:


gcloud sql instances describe [INSTANCE_NAME] | grep connectionName

Autorizações

Tem de ter, pelo menos, a autorização cloudsql.client no projeto do Cloud SQL para MySQL para criar a ligação. Se não tiver (ou não conseguir) este acesso, pode usar o conetor MySQL em alternativa.

Conetividade de rede

O conetor do Cloud SQL para MySQL suporta ligações a instâncias do Cloud SQL para MySQL com conetividade de IP público e conetividade de IP privado.

Tem de configurar a conetividade de IP público ou a conetividade de IP privado para a sua instância do Cloud SQL para MySQL antes de usar o conetor do Cloud SQL para MySQL.

Para permitir que o Looker Studio aceda a dados no Cloud SQL e faça consultas a estes dados através de uma ligação privada, selecione a opção Caminho privado para serviços Google Cloud nas definições da instância do Cloud SQL para MySQL.

Tipos de dados

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

Nota : o Looker Studio não suporta extensões de dados espaciais do MySQL.

Limites do conetor do Cloud SQL para MySQL

  • Pode consultar um máximo de 150 mil linhas por consulta através deste conector. Se exceder este limite, os dados são truncados.
  • Os cabeçalhos das colunas (nomes dos campos) têm de usar apenas carateres ASCII. Os carateres não ASCII não são suportados.

Resolução de problemas

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