Skip to main content

​
1. Configurer une connexion à ClickHouse

Pour établir une connexion à ClickHouse, accédez à la page Connections, sélectionnez New Connection, puis choisissez ClickHouse dans la fenêtre modale New Connection. Vous devrez renseigner un host, un username et un password :
  • Host : il s’agit du host sur lequel votre base de données ClickHouse est exposée. Notez que seul https est autorisé ici afin de transférer les données de façon sécurisée. La structure attendue pour l’URL du host est la suivante : https://url-to-clickhouse-db:port/database Par défaut, le plugin se connecte à la base de données ‘default’ sur le port 443. En indiquant une base de données après le ’/’, vous pouvez définir la base de données à laquelle vous connecter.
  • Username : le username qui sera utilisé pour se connecter à votre cluster ClickHouse.
  • Password : le password permettant de se connecter à votre cluster ClickHouse
Consultez les exemples de notre documentation développeur pour savoir comment créer une connexion à ClickHouse via notre API.

​
2. Ajouter des jeux de données

Une fois votre instance ClickHouse connectée, vous pouvez ajouter des jeux de données comme expliqué ici. Vous pouvez sélectionner un ou plusieurs jeux de données disponibles dans ClickHouse et les lier dans Luzmo afin de pouvoir les utiliser ensemble dans un tableau de bord. Pensez également à consulter cet article sur la préparation de vos données pour l’analyse. Pour savoir comment ajouter des jeux de données à l’aide de notre API, consultez cet exemple dans notre documentation développeur. Vous pouvez désormais utiliser vos jeux de données pour créer de superbes tableaux de bord (intégrés), ou même alimenter un analyste de données IA (Luzmo IQ) capable de répondre aux questions de vos clients.

​
Notes d’utilisation

  1. Le connecteur ClickHouse de Luzmo utilise l’interface HTTP de l’API (généralement en écoute sur le port 8123) pour se connecter.
  2. Si vous utilisez des tables avec le moteur de table Distributed, certains graphiques Luzmo peuvent échouer lorsque distributed_product_mode est défini sur deny. Cela ne devrait toutefois se produire que si vous liez la table à une autre table et utilisez cette liaison dans un graphique. Dans ce cas, veillez à définir distributed_product_mode sur une autre option adaptée à votre cluster ClickHouse. Si vous utilisez ClickHouse Cloud, vous pouvez ignorer ce paramètre en toute sécurité.
  3. Pour garantir, par exemple, que seule l’application Luzmo puisse accéder à votre instance ClickHouse, il est fortement recommandé d’autoriser la plage d’adresses IP statiques de Luzmo. Nous recommandons également d’utiliser un utilisateur technique en lecture seule.
  4. Le connecteur ClickHouse prend actuellement en charge les types de données suivants :
Dernière modification le 3 juillet 2026