Pular para o conteúdo principal
O Looker Studio pode se conectar ao ClickHouse pela interface MySQL usando a fonte de dados MySQL oficial do Google.

​
Configuração do ClickHouse Cloud

1

​
Selecione Connect your app

Após criar seu ClickHouse Cloud serviço, na tela Connect your app, selecione MySQL no menu suspenso.
2

​
Habilite a interface MySQL

Ative a chave para habilitar a interface MySQL neste serviço específico. Isso exporá a porta 3306 para esse serviço e exibirá uma tela de conexão MySQL com seu nome de usuário MySQL exclusivo.Como alternativa, para habilitar a interface MySQL em um serviço existente:
3

​
Selecione Connect

Verifique se seu serviço está no estado Running e clique no serviço para o qual você quer habilitar a interface MySQL. Selecione “Connect” no menu à esquerda:
4

​
Escolha MySQL

Selecione MySQL no menu suspenso Connect With.
5

​
Habilite a interface MySQL

Ative a chave para habilitar a interface MySQL neste serviço específico. Isso exporá a porta 3306 para esse serviço e exibirá sua tela de conexão MySQL, incluindo seu nome de usuário MySQL exclusivo.

​
Criando um usuário MySQL somente leitura no ClickHouse Cloud

O ClickHouse Cloud cria automaticamente um usuário mysql4<subdomain> que usa a mesma senha do usuário padrão. A parte <subdomain> corresponde à primeira parte do hostname do seu ClickHouse Cloud. Esse formato de nome de usuário é necessário para compatibilidade com ferramentas que estabelecem conexões seguras, mas não incluem dados de SNI (Server Name Indication) no handshake de TLS. Sem as informações de SNI, o sistema não consegue fazer o roteamento interno corretamente, então o subdomínio incorporado ao nome de usuário fornece as informações de roteamento necessárias. O cliente de console do MySQL é um exemplo de ferramenta que precisa disso.
Uma prática recomendada é criar um novo usuário MySQL somente leitura.
Para um hostname do ClickHouse Cloud como foobar.us-east1.aws.clickhouse.cloud, a parte <subdomain> é foobar, e um nome de usuário MySQL personalizado poderia ser algo como mysql4foobar_team1.
1

​
Crie um perfil de configurações de somente leitura

Crie um perfil de configurações para aplicar ao seu usuário somente leitura, definindo a configuração readonly como 1:
2

​
Crie um novo usuário MySQL somente leitura

Crie um usuário com um nome neste formato:
Aplique o readonly_profile ao novo usuário e certifique-se de que a senha esteja no formato double SHA1. Por exemplo:
3

​
Conceda ao novo usuário permissões para acessar as tabelas desejadas

Conceda ao novo usuário as permissões necessárias para interagir com as tabelas ou bancos de dados desejados. Por exemplo, se você quiser conceder acesso apenas a system.query_log:
Para o usuário somente leitura, certifique-se de conceder apenas permissões SELECT às tabelas que você deseja acessar.
O usuário recém-criado pode ser usado para se conectar ao seu serviço do ClickHouse Cloud pela interface MySQL.

​
Solução de problemas com vários usuários MySQL no ClickHouse Cloud

Se você criou um novo usuário MySQL e vê o seguinte erro ao se conectar pelo cliente de linha de comando do MySQL:
Nesse caso, certifique-se de que o nome de usuário siga o formato mysql4<subdomain>_<username>, conforme descrito (acima).

​
Configuração do servidor ClickHouse on-premise

Consulte a documentação oficial para saber como configurar um servidor ClickHouse com a interface MySQL habilitada. Além de adicionar uma entrada ao config.xml do servidor
também é obrigatório usar criptografia de senha com Double SHA1 para o usuário que usará a interface MySQL. Como gerar, no shell, uma senha aleatória criptografada com Double SHA1:
A saída deve ser semelhante à seguinte:
A primeira linha é a senha gerada, e a segunda linha é o hash que pode ser usado para configurar o ClickHouse. Aqui está um exemplo de configuração para mysql_user que usa o hash gerado: /etc/clickhouse-server/users.d/mysql_user.xml
Substitua a entrada password_double_sha1_hex pelo hash Double SHA1 gerado por você. Além disso, é recomendável usar use_mysql_types_in_show_columns para exibir os tipos nativos do MySQL em vez dos do ClickHouse nos resultados da consulta SHOW [FULL] COLUMNS, o que permite que ferramentas de BI inspecionem corretamente o esquema do banco de dados ao usar conectores MySQL. Por exemplo: /etc/clickhouse-server/users.d/mysql_user.xml
ou atribuí-lo a outro profile em vez do profile padrão. Se você tiver o binário mysql disponível, poderá testar a conexão pela linha de comando. Usando o nome de usuário de exemplo (mysql_user) e a senha (LZOQYnqQN4L/T6L0) acima, o comando seria:
Por fim, configure o ClickHouse Server para escutar no(s) endereço(s) IP desejado(s). Por exemplo, em config.xml, descomente o trecho a seguir para escutar em todos os endereços:

​
Conectando o Looker Studio ao ClickHouse

Primeiro, faça login em https://lookerstudio.google.com com sua conta do Google e crie uma nova fonte de dados:
Procure o conector oficial do MySQL fornecido pelo Google (chamado simplesmente de MySQL):
Informe os detalhes da conexão. Observe que a porta da interface MySQL é 9004 por padrão e pode variar dependendo da configuração do servidor.
Agora, você tem duas opções para buscar os dados do ClickHouse. Primeiro, pode usar o recurso Navegador de tabelas:
Como alternativa, você pode especificar uma consulta personalizada para buscar seus dados:
Por fim, você deverá conseguir ver a estrutura da tabela identificada automaticamente e ajustar os tipos de dados, se necessário.
Agora você pode continuar explorando seus dados ou criar um novo relatório!

​
Usando o Looker Studio com ClickHouse Cloud

Ao usar o ClickHouse Cloud, é preciso primeiro habilitar a interface MySQL. Você pode fazer isso na caixa de diálogo de conexão, na aba “MySQL”.
Na UI do Looker Studio, escolha a opção “Enable SSL”. O certificado SSL do ClickHouse Cloud é assinado pela Let’s Encrypt. Você pode baixar esse certificado raiz aqui.
O restante das etapas é o mesmo listado acima na seção anterior.
Última modificação em 12 de junho de 2026