Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

Connecter Superset à ClickHouse

View as MarkdownEdit this pageReport an issueSet up docs MCP
Compatible avec ClickHouse

Apache Superset est une plateforme open-source d’exploration de données et de visualisation écrite en Python. Superset se connecte à ClickHouse à l’aide d’un pilote Python fourni par ClickHouse. Voyons comment cela fonctionne…

Objectif

Dans ce guide, vous allez créer un tableau de bord dans Superset à partir de données issues d’une base de données ClickHouse. Le tableau de bord ressemblera à ceci :

Tableau de bord Superset affichant les prix de l’immobilier au Royaume-Uni avec plusieurs visualisations, dont des diagrammes circulaires et des tableaux

Récupérez vos informations de connexion

Pour vous connecter à ClickHouse via HTTP(S), vous avez besoin des informations suivantes :

Paramètre(s) Description
HOST and PORT En général, le port est 8443 lors de l’utilisation de TLS, ou 8123 sans TLS.
DATABASE NAME Par défaut, une base de données nommée default est disponible ; utilisez le nom de la base de données à laquelle vous voulez vous connecter.
USERNAME and PASSWORD Par défaut, le nom d’utilisateur est default. Utilisez le nom d’utilisateur adapté à votre cas d’usage.

Les informations de votre service ClickHouse Cloud sont disponibles dans la console ClickHouse Cloud. Sélectionnez un service, puis cliquez sur Connect :

Bouton Connect du service ClickHouse Cloud

Choisissez HTTPS. Les détails de connexion s’affichent dans un exemple de commande curl.

Détails de connexion HTTPS ClickHouse Cloud

Si vous utilisez ClickHouse autogéré, les détails de connexion sont définis par votre administrateur ClickHouse.

Installer le pilote

  1. Superset utilise le pilote clickhouse-connect pour se connecter à ClickHouse. Les détails de clickhouse-connect sont disponibles à l’adresse https://pypi.org/project/clickhouse-connect/, et il peut être installé avec la commande suivante :

    pip install clickhouse-connect
  1. Démarrez (ou redémarrez) Superset.

Connecter Superset à ClickHouse

  1. Dans Superset, sélectionnez Data dans le menu supérieur, puis Databases dans le menu déroulant. Ajoutez une nouvelle base de données en cliquant sur le bouton + Database :
Interface de Superset montrant le menu Database avec le bouton + Database mis en évidence

  1. À la première étape, sélectionnez ClickHouse Connect comme type de base de données :
Assistant de connexion à une base de données dans Superset montrant l’option ClickHouse Connect sélectionnée

  1. À la deuxième étape :
  • Activez ou désactivez SSL.
  • Saisissez les informations de connexion que vous avez relevées précédemment
  • Indiquez le DISPLAY NAME : vous pouvez choisir n’importe quel nom. Si vous vous connectez à plusieurs bases de données ClickHouse, choisissez un nom plus explicite.
Formulaire de configuration de connexion de Superset montrant les paramètres de connexion à ClickHouse

  1. Cliquez sur CONNECT, puis sur FINISH pour terminer l’assistant de configuration. Votre base de données devrait alors apparaître dans la liste des bases de données.

Ajouter un jeu de données

  1. Pour interagir avec vos données ClickHouse dans Superset, vous devez définir un jeu de données. Dans le menu supérieur de Superset, sélectionnez Data, puis Datasets dans la liste déroulante.

  2. Cliquez sur le bouton pour ajouter un jeu de données. Sélectionnez votre nouvelle base de données comme source de données et vous devriez voir les tables définies dans votre base de données :

Boîte de dialogue de création de jeu de données Superset affichant les tables disponibles de la base de données ClickHouse

  1. Cliquez sur le bouton ADD en bas de la boîte de dialogue, et votre table apparaît dans la liste des jeux de données. Vous êtes prêt à créer un tableau de bord et à analyser vos données ClickHouse !

Création de graphiques et d’un tableau de bord dans Superset

Si vous connaissez déjà Superset, vous vous sentirez tout de suite à l’aise dans cette section. Si vous découvrez Superset, eh bien… c’est comme beaucoup d’autres excellents outils de visualisation : la prise en main est rapide, mais on en apprend les détails et les subtilités au fil de l’usage.

  1. Vous commencez par un tableau de bord. Dans le menu supérieur de Superset, sélectionnez Dashboards. Cliquez sur le bouton en haut à droite pour ajouter un nouveau tableau de bord. Le tableau de bord suivant s’appelle UK property prices :
Tableau de bord Superset vide nommé UK property prices, prêt à recevoir des graphiques

  1. Pour créer un nouveau graphique, sélectionnez Charts dans le menu supérieur, puis cliquez sur le bouton pour ajouter un nouveau graphique. De nombreuses options s’affichent. L’exemple suivant montre un graphique Pie Chart utilisant le jeu de données uk_price_paid dans la liste déroulante CHOOSE A DATASET :
Interface de création de graphique Superset avec le type de visualisation Pie Chart sélectionné

  1. Les graphiques en secteurs de Superset nécessitent une Dimension et une Metric ; tous les autres paramètres sont facultatifs. Vous pouvez choisir les champs de votre choix pour la dimension et la métrique ; dans cet exemple, le champ ClickHouse district est utilisé comme dimension et AVG(price) comme métrique.
Configuration de la dimension montrant le champ district sélectionné pour le graphique en secteurs
Configuration de la métrique montrant la fonction d’agrégation AVG(price) pour le graphique en secteurs

  1. Si vous préférez les graphiques en anneau aux graphiques en secteurs, vous pouvez définir cette option et d’autres sous CUSTOMIZE :
Panneau Customize montrant l’option de graphique en anneau et d’autres paramètres de configuration du graphique en secteurs

  1. Cliquez sur le bouton SAVE pour enregistrer le graphique, puis sélectionnez UK property prices dans la liste déroulante ADD TO DASHBOARD ; SAVE & GO TO DASHBOARD enregistre alors le graphique et l’ajoute au tableau de bord :
Boîte de dialogue d’enregistrement du graphique avec liste déroulante de sélection du tableau de bord et bouton Save & Go to Dashboard

  1. C’est tout. Créer des tableaux de bord dans Superset à partir des données de ClickHouse ouvre tout un monde d’analyses de données ultra-rapides !
Tableau de bord Superset finalisé avec plusieurs visualisations des données sur les prix de l’immobilier au Royaume-Uni provenant de ClickHouse

Navigation