Passer au contenu principal
Looker Studio peut se connecter à ClickHouse via l’interface MySQL à l’aide de la source de données MySQL officielle de Google.

​
Configuration de ClickHouse Cloud

1

​
Sélectionnez Connect your app

Après avoir créé votre service ClickHouse Cloud, dans l’écran Connect your app, sélectionnez MySQL dans la liste déroulante.
2

​
Activez l’interface MySQL

Basculez l’interrupteur pour activer l’interface MySQL pour ce service. Le port 3306 sera alors exposé pour ce service et un écran de connexion MySQL s’affichera avec votre nom d’utilisateur MySQL unique.Vous pouvez également activer l’interface MySQL pour un service existant :
3

​
Sélectionnez Connect

Assurez-vous que votre service est à l’état Running, puis cliquez sur le service pour lequel vous souhaitez activer l’interface MySQL. Sélectionnez “Connect” dans le menu de gauche :
4

​
Choisissez MySQL

Sélectionnez MySQL dans la liste déroulante Connect With.
5

​
Activez l’interface MySQL

Basculez l’interrupteur pour activer l’interface MySQL pour ce service. Le port 3306 sera alors exposé pour ce service et votre écran de connexion MySQL s’affichera avec votre nom d’utilisateur MySQL unique.

​
Création d’un utilisateur MySQL readonly dans ClickHouse Cloud

ClickHouse Cloud crée automatiquement un utilisateur mysql4<subdomain> qui partage le même mot de passe que l’utilisateur default. La partie <subdomain> correspond à la première partie du nom d’hôte de votre instance ClickHouse Cloud. Ce format de nom d’utilisateur est requis pour assurer la compatibilité avec les outils qui établissent des connexions sécurisées mais n’incluent pas les données SNI (Server Name Indication) dans leur handshake TLS. Sans informations SNI, le système ne peut pas effectuer le routage interne correctement ; l’indication de sous-domaine intégrée au nom d’utilisateur fournit donc les informations de routage nécessaires. Le client de console MySQL est un exemple d’outil qui en a besoin.
Il est recommandé de créer un nouvel utilisateur MySQL readonly.
Pour un nom d’hôte ClickHouse Cloud tel que foobar.us-east1.aws.clickhouse.cloud, la partie <subdomain> est égale à foobar, et un nom d’utilisateur MySQL personnalisé pourrait être mysql4foobar_team1.
1

​
Créer un profil de paramètres readonly

Créez un profil de paramètres à appliquer à votre utilisateur readonly, en définissant le paramètre readonly sur 1 :
2

​
Créer un nouvel utilisateur MySQL readonly

Créez un utilisateur avec un nom respectant ce format :
Appliquez readonly_profile au nouvel utilisateur et assurez-vous que le mot de passe est au format double SHA1. Par exemple :
3

​
Accorder au nouvel utilisateur les permissions nécessaires pour accéder aux tables souhaitées

Accordez au nouvel utilisateur les permissions nécessaires pour interagir avec les tables ou bases de données souhaitées. Par exemple, si vous souhaitez accorder l’accès uniquement à system.query_log :
Pour l’utilisateur readonly, veillez à n’accorder que des permissions SELECT sur les tables auxquelles vous souhaitez accéder.
L’utilisateur nouvellement créé peut être utilisé pour se connecter à votre service ClickHouse Cloud via l’interface MySQL.

​
Troubleshooting de plusieurs utilisateurs MySQL dans ClickHouse Cloud

Si vous avez créé un nouvel utilisateur MySQL et que l’erreur suivante s’affiche lorsque vous vous connectez via le client MySQL en CLI :
Dans ce cas, assurez-vous que le nom d’utilisateur respecte le format mysql4<subdomain>_<username>, comme indiqué (ci-dessus).

​
Configuration d’un serveur ClickHouse sur site

Veuillez consulter la documentation officielle pour savoir comment configurer un serveur ClickHouse avec l’interface MySQL activée. Outre l’ajout d’une entrée au config.xml du serveur
il est également nécessaire d’utiliser le chiffrement de mot de passe Double SHA1 pour l’utilisateur qui utilisera l’interface MySQL. Génération d’un mot de passe aléatoire chiffré en Double SHA1 depuis le shell :
Le résultat devrait ressembler à ce qui suit :
La première ligne correspond au mot de passe généré, et la deuxième au hash que nous pouvons utiliser pour configurer ClickHouse. Voici un exemple de configuration pour mysql_user utilisant le hash généré : /etc/clickhouse-server/users.d/mysql_user.xml
Remplacez l’entrée password_double_sha1_hex par votre propre hachage Double SHA1 généré. De plus, il est recommandé d’utiliser use_mysql_types_in_show_columns pour afficher les types MySQL natifs au lieu de ceux de ClickHouse dans les résultats de la requête SHOW [FULL] COLUMNS, ce qui permet aux outils de BI d’inspecter correctement le schéma de la base de données lors de l’utilisation de connecteurs MySQL. Par exemple : /etc/clickhouse-server/users.d/mysql_user.xml
ou l’affecter à un profil différent plutôt qu’au profil par défaut. Si le binaire mysql est disponible, vous pouvez tester la connexion depuis la ligne de commande. En utilisant l’exemple de nom d’utilisateur (mysql_user) et de mot de passe (LZOQYnqQN4L/T6L0) ci-dessus, la ligne de commande serait :
Enfin, configurez le serveur ClickHouse pour qu’il écoute sur la ou les adresses IP souhaitées. Par exemple, dans config.xml, décommentez les lignes suivantes pour écouter sur toutes les adresses :

​
Connexion de Looker Studio à ClickHouse

Commencez par vous connecter à https://lookerstudio.google.com avec votre compte Google, puis créez une nouvelle source de données :
Recherchez le connecteur MySQL officiel fourni par Google (appelé simplement MySQL) :
Indiquez vos informations de connexion. Veuillez noter que le port de l’interface MySQL est 9004 par défaut, mais qu’il peut être différent selon la configuration de votre serveur.
Vous avez maintenant deux possibilités pour récupérer les données depuis ClickHouse. Vous pouvez d’abord utiliser la fonctionnalité Table Browser :
Vous pouvez également indiquer une requête personnalisée pour récupérer vos données :
Enfin, vous devriez pouvoir voir la structure de la table inspectée et ajuster les types de données si nécessaire.
Vous pouvez maintenant explorer vos données ou créer un nouveau rapport !

​
Utiliser Looker Studio avec ClickHouse Cloud

Lorsque vous utilisez ClickHouse Cloud, vous devez d’abord activer l’interface MySQL. Vous pouvez le faire dans la boîte de dialogue de connexion, dans l’onglet « MySQL ».
Dans l’UI de Looker Studio, sélectionnez l’option « Enable SSL ». Le certificat SSL de ClickHouse Cloud est signé par Let’s Encrypt. Vous pouvez télécharger ce certificat racine ici.
Les autres étapes sont identiques à celles indiquées ci-dessus dans la section précédente.
Dernière modification le 2 juillet 2026