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 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 do Looker Studio. Também pode adicionar e votar em pedidos de funcionalidades no Issue Tracker.

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
        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úblicas, 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 a 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 se associar 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 da 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. Navegue para 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.