É 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 e dashboards interativos. Em seguida, compartilhe esses insights com stakeholders ou 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 que você fornecer.
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 AUTHENTICATE. 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 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 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. Esse SQL personalizado é usado como uma instrução SELECT interna no Data Studio 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 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.
Observações
Confira as seções a seguir para mais detalhes sobre como encontrar o nome da conexão da instância, configurar as permissões necessárias e configurar 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 Google Cloud console ou use 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ê 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
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 em vez disso.
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, configure a conectividade de IP público ou de 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, a API não 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)
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 compatíveis.
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.