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.
Versões compatíveis
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
- Faça login no Looker Studio.
- Na parte de cima à esquerda da página inicial do Looker Studio, clique em Criar e selecione Fonte de dados.
- Selecione o conector do Cloud SQL para MySQL.
- Se solicitado, autorize o Looker Studio a acessar seus dados.
Configure a conexão ao seu banco de dados:
- Para se conectar com um nome de host ou endereço IP
- À esquerda, selecione BÁSICO .
- Digite os detalhes da conexão:
- Nome da conexão da instância (confira abaixo como listar suas conexões).
- Banco de dados
- Nome de usuário
- Senha
- Para se conectar com um URL JDBC
- À esquerda, selecione URL JDBC .
- Digite os detalhes da conexão:
- URL JDBC
Exemplo
jdbc:google:mysql: //
<instance connection name>/
- Nome de usuário
- Senha
- URL JDBC
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.
- Para se conectar com um nome de host ou endereço IP
Clique em AUTENTICAR.
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.
- 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.
- Acesse https://console.cloud.google.com/sql/instances.
- Clique no ID da instância a que você quer se conectar.
- À 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.