Conectar-se ao Google Cloud SQL para MySQL

O Cloud SQL para MySQL é um serviço de banco de dados totalmente gerenciado que facilita a configuração, a manutenção, o gerenciamento e a administração dos seus bancos de dados relacionais do MySQL no Cloud Platform. Com o conector do Cloud SQL para MySQL, é possível acessar dados dos bancos de dados desse serviço no Looker Studio.

O conector do Cloud SQL para MySQL foi testado 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.

Como se conectar ao Cloud SQL para MySQL

Uma fonte de dados do Looker Studio pode se conectar a uma única tabela de banco de dados do Cloud SQL para MySQL ou a uma consulta personalizada.

Para conectar

  1. Faça login no Looker Studio.
  2. Na parte de cima à esquerda da página inicial do Looker Studio, clique em Ícone "Criar". Criar e selecione Fonte de dados.
  3. Selecione o conector do Cloud SQL para MySQL.
  4. Se solicitado, autorize o Looker Studio a acessar seus dados.
  5. Configure a conexão ao seu banco de dados:

    • Para se conectar com um nome de host ou endereço IP
      1. À esquerda, selecione BÁSICO .
      2. Digite os detalhes da conexão:
        1. Nome da conexão da instância (confira abaixo como listar suas conexões).
        2. Banco de dados
        3. Nome de usuário
        4. Senha
    • Para se conectar com um URL JDBC
      1. À esquerda, selecione URL JDBC .
      2. Digite os detalhes da conexão:
        1. URL JDBC

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

        2. Nome de usuário
        3. 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:google:mysql://\[2001:db8:1:1:1:1:1:1\]/your_db
    • Observação : não é possível conectar o Looker Studio ao localhost. É necessário usar um nome do host ou um endereço IP público.
  6. Clique em AUTENTICAR.

  7. 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.
  1. 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

Encontrar o nome da conexão da instância

Esse nome identifica a instância no Google Cloud. Você pode acessar o console do Google Cloud ou usar a linha de comando.

Use o console.

  1. Acesse https://console.cloud.google.com/sql/instances.
  2. Clique no ID da instância a que você quer se conectar.
  3. À esquerda, você encontra o nome da conexão na seção "Conectar-se a esta instância".

Usar a linha de comando

Para encontrar o nome da conexão com a interface de linha de comando do Cloud, use o seguinte comando:


gcloud sql instances describe [INSTANCE_NAME] | grep connectionName

Permissões

Para criar a conexão, você precisa ter pelo menos a permissão cloudsql.client no projeto do Cloud SQL para MySQL. Se você não tiver ou não conseguir esse acesso, use o conector do MySQL.

Conectividade de rede

O conector do Cloud SQL para MySQL aceita conexões a instâncias desse serviço com conectividade de IP público e particular.

Antes de usar o conector, configure a conectividade de IP público ou IP particular na sua instância do Cloud SQL para MySQL.

Para permitir que o Looker Studio acesse dados no Cloud SQL e faça consultas com base neles usando uma conexão particular, selecione a opção Caminho particular para serviços do Google Cloud nas configurações da instância do Cloud SQL para MySQL.

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.

Limites do conector do Cloud SQL para 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.