É possível conectar seus bancos de dados do Cloud SQL para MySQL ao Data Studio usando o conector do Cloud SQL para MySQL. Use as tabelas do banco de dados ou consultas personalizadas para criar relatórios interativos e painéis. Depois, você pode compartilhar esses insights com as partes interessadas ou os membros da equipe que não têm acesso direto ao banco de dados.
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 do Data Studio. Também é possível adicionar e votar em solicitações de recursos no Issue Tracker.
Como se conectar ao Cloud SQL para MySQL
Uma fonte de dados do Data Studio pode se conectar a uma única tabela de banco de dados do Cloud SQL para MySQL ou a uma consulta personalizada.
Para se conectar ao banco de dados do Cloud SQL para MySQL, siga estas etapas:
- Faça login no Data Studio.
- Na página inicial do Data Studio, clique em Criar e selecione Fonte de dados.
- Selecione o conector do Cloud SQL para MySQL.
- Para configurar o acesso ao seu banco de dados, use uma das opções de conexão.
- Clique em AUTENTICAR. Você verá uma lista de tabelas nesse banco de dados.
- Selecione uma tabela na lista ou insira uma consulta personalizada.
- Clique em CONECTAR.
Agora você pode acessar todas as colunas da tabela como campos nos seus relatórios.
Opções de conexão
Conectar-se usando um nome do host ou endereço IP
No painel de conexão, selecione BÁSICO. Digite os detalhes da conexão:
- Nome da conexão da instância
- Banco de dados
- Nome de usuário
- Senha
Conectar-se usando um URL JDBC
No painel de conexão, selecione URL JDBC. Digite os detalhes da conexão:
- URL JDBC
Exemplo
jdbc:google:mysql://INSTANCE_CONNECTION_NAME/DATABASE
- Nome de usuário
- Senha
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
Consulta personalizada
Selecione a opção CONSULTA PERSONALIZADA para estabelecer uma consulta SQL, em vez de se conectar a uma única tabela. O Data Studio usa esse SQL personalizado como uma instrução SELECT interna a cada consulta gerada para o banco de dados.
As consultas SQL personalizadas só podem ter uma instrução. 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 Data Studio podem atingir o tempo limite depois de 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.
Observações
Confira as seções a seguir para saber como encontrar o nome da conexão da instância, configurar as permissões necessárias e definir a conectividade de rede.
Encontrar o nome da conexão da instância
Esse nome identifica a instância no Google Cloud. Para saber qual é, acesse o console do Google Cloud ou use a linha de comando.
Usar o console
- Acesse https://console.cloud.google.com/sql/instances.
- Clique no ID da instância a que você quer se conectar.
- À esquerda, você verá 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
Você vai precisar pelo menos da permissão cloudsql.client no projeto do Cloud SQL para MySQL se quiser criar a conexão. 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 do Cloud SQL para MySQL com conectividade de IP público e particular.
Antes de usar o conector do Cloud SQL para MySQL, configure a conexão por IP público ou conexão por IP particular na sua instância do Cloud SQL para MySQL.
Para permitir que o Data 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 compatíveis
O Data Studio mapeia os tipos de dados integrados do seu banco de dados para um conjunto unificado de tipos de dados. Se o Data Studio encontrar uma coluna não compatível na tabela ou consulta, ele não vai criar um campo para ela.Firewall e acesso ao banco de dados
Para permitir que o Data Studio se conecte e consulte bancos de dados protegidos por firewall, abra o acesso a um dos seguintes endereços IP. Talvez também seja necessário configurar seu banco de dados para aceitar tráfego desses endereços. Consulte a documentação do seu banco de dados específico para saber como fazer isso.
Endereços IP
Os seguintes endereços são reservados para a infraestrutura global do Data Studio:
142.251.74.0/232001:4860:4807::/48(opcional, para plataformas com suporte a IPv6)
Se você ativou a residência de dados na sua assinatura do Data Studio Pro, use os seguintes endereços:
142.251.56.0/242001:4860:4815::/48(opcional, para plataformas com suporte a IPv6)
Limites do conector do Cloud SQL para MySQL
- O Data Studio não é compatível com extensões de dados espaciais do 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 Data Studio para conferir uma lista de mensagens de erro comuns e as etapas para resolvê-los.