> ## Documentation Index > Fetch the complete documentation index at: https://private-7c7dfe99-detect-table-modification.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. > Tableau peut utiliser les bases de données et les tables ClickHouse comme source de données. # Connexion de Tableau à ClickHouse export const ClickHouseSupportedBadge = () => { return
Compatible avec ClickHouse
; }; export const Image = ({img, alt, size = "lg"}) => { const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg"; return
{alt}
; }; ClickHouse propose un connecteur Tableau officiel, disponible sur le [Tableau Exchange](https://exchange.tableau.com/products/1064). Ce connecteur s’appuie sur le [JDBC driver](/fr/integrations/language-clients/java/jdbc) avancé de ClickHouse. Grâce à ce connecteur, Tableau peut utiliser les bases de données et les tables ClickHouse comme sources de données. Pour activer cette fonctionnalité, suivez le guide de configuration ci-dessous.
## Configuration requise avant utilisation
1. Rassemblez 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. 2. Téléchargez et installez Tableau Desktop. 3. Suivez les instructions de `clickhouse-tableau-connector-jdbc` pour télécharger la version compatible du ClickHouse JDBC driver. Assurez-vous de télécharger le fichier JAR [clickhouse-jdbc-X.X.X-all-dependencies.jar](https://github.com/ClickHouse/clickhouse-java/releases). Cet artefact est disponible à partir de la version `0.9.2`. 4. Placez le JDBC driver dans le dossier suivant (selon votre OS ; si le dossier n'existe pas, vous pouvez le créer) : * macOS : `~/Library/Tableau/Drivers` * Windows : `C:\Program Files\Tableau\Drivers` 5. Configurez une source de données ClickHouse dans Tableau et commencez à créer des visualisations de données !
## Configurer une source de données ClickHouse dans Tableau
Maintenant que le pilote `clickhouse-jdbc` est installé et configuré, voyons comment définir une source de données dans Tableau qui se connecte à la base de données **TPCD** dans ClickHouse. 1. Lancez Tableau. (S'il était déjà ouvert, redémarrez-le.) 2. Dans le menu de gauche, cliquez sur **More** dans la section **To a Server**. Recherchez **ClickHouse by ClickHouse** dans la liste des connecteurs disponibles : Écran de connexion de Tableau montrant le menu de sélection du connecteur, avec l'option ClickHouse by ClickHouse mise en évidence
Vous ne voyez pas le connecteur **ClickHouse by ClickHouse** dans votre liste de connecteurs ? Cela peut être lié à une ancienne version de Tableau Desktop. Pour résoudre ce problème, envisagez de mettre à jour votre application Tableau Desktop, ou [d'installer le connecteur manuellement](#install-the-connector-manually). 3. Cliquez sur **ClickHouse by ClickHouse** et la boîte de dialogue suivante s'affichera : Boîte de dialogue d'installation du connecteur Tableau affichant les détails du connecteur ClickHouse JDBC et le bouton d'installation
4. Cliquez sur **Install and Restart Tableau**. Redémarrez l'application. 5. Après le redémarrage, le connecteur affichera son nom complet : `ClickHouse JDBC by ClickHouse, Inc.`. En cliquant dessus, la boîte de dialogue suivante s'affichera : Boîte de dialogue de connexion ClickHouse dans Tableau affichant les champs server, port, database, username et password
6. Saisissez vos informations de connexion : | Setting | Value | | -------- | --------------------------------------------------- | | Server | **Votre hôte ClickHouse (sans préfixe ni suffixe)** | | Port | **8443** | | Database | **default** | | Username | **default** | | Password | \*\*\*\*\*\* | Lorsque vous utilisez ClickHouse Cloud, vous devez cocher la case SSL pour sécuriser la connexion.
Notre base de données ClickHouse s'appelle **TPCD**, mais vous devez définir **Database** sur **default** dans la boîte de dialogue ci-dessus, puis sélectionner **TPCD** pour **Schema** à l'étape suivante. (Cela est probablement dû à un bug du connecteur ; ce comportement pourra donc changer, mais pour l'instant, vous devez utiliser **default** comme base de données.) 7. Cliquez sur le bouton **Sign In** et vous devriez voir un nouveau workbook Tableau : Nouveau workbook Tableau affichant l'écran de connexion initial avec les options de sélection de base de données
8. Sélectionnez **TPCD** dans la liste déroulante **Schema** et vous devriez voir la liste des tables dans **TPCD** : Sélection du schéma dans Tableau affichant les tables de la base de données TPCD, notamment CUSTOMER, LINEITEM, NATION, ORDERS et d'autres
Vous êtes maintenant prêt à créer des visualisations dans Tableau !
## Créer des visualisations dans Tableau
Maintenant que nous avons configuré une source de données ClickHouse dans Tableau, passons à la visualisation des données... 1. Faites glisser la table **CUSTOMER** dans le workbook. Notez que les colonnes apparaissent, mais que la table de données est vide : Workbook Tableau avec la table CUSTOMER glissée sur le canevas, montrant les en-têtes de colonnes mais aucune donnée
2. Cliquez sur le bouton **Update Now** et 100 lignes de **CUSTOMER** rempliront la table. 3. Faites glisser la table **ORDERS** dans le workbook, puis définissez **Custkey** comme champ de relation entre les deux tables : Éditeur de relations Tableau montrant la connexion entre les tables CUSTOMER et ORDERS à l'aide du champ Custkey
4. Les tables **ORDERS** et **LINEITEM** sont maintenant associées dans votre source de données, vous pouvez donc utiliser cette relation pour répondre à des questions sur les données. Sélectionnez l'onglet **Sheet 1** en bas du workbook. Feuille de calcul Tableau montrant les dimensions et mesures des tables ClickHouse disponibles pour l'analyse
5. Supposons que vous vouliez savoir combien d'articles spécifiques ont été commandés chaque année. Faites glisser **OrderDate** de **ORDERS** dans la section **Columns** (le champ horizontal), puis faites glisser **Quantity** de **LINEITEM** dans **Rows**. Tableau générera le graphique linéaire suivant : Graphique linéaire Tableau montrant la quantité commandée par année à partir de données ClickHouse
Ce n'est pas un graphique linéaire très passionnant, mais le jeu de données a été généré par un script et conçu pour tester les performances des requêtes, donc vous remarquerez qu'il n'y a pas beaucoup de variation dans les commandes simulées des données TCPD. 6. Supposons que vous vouliez connaître le montant moyen des commandes (en dollars) par trimestre, ainsi que par mode d'expédition (avion, courrier, navire, camion, etc.) : * Cliquez sur l'onglet **New Worksheet** pour créer une nouvelle feuille * Faites glisser **OrderDate** de **ORDERS** dans **Columns** et remplacez **Year** par **Quarter** * Faites glisser **Shipmode** de **LINEITEM** dans **Rows** Vous devriez voir ce qui suit : Vue en tableau croisé Tableau avec les trimestres en colonnes et les modes d'expédition en lignes
7. Les valeurs **Abc** ne servent qu'à occuper l'espace jusqu'à ce que vous fassiez glisser une métrique sur la table. Faites glisser **Totalprice** de \* *ORDERS*\* sur la table. Notez que le calcul par défaut consiste à **SUM** les **Totalprices** : Tableau croisé Tableau montrant la somme du prix total par trimestre et par mode d'expédition
8. Cliquez sur **SUM** et remplacez **Measure** par **Average**. Dans le même menu déroulant, sélectionnez **Format** puis remplacez **Numbers** par **Currency (Standard)** : Tableau croisé Tableau montrant le prix moyen des commandes par trimestre et par mode d'expédition avec format monétaire
Bravo ! Vous avez connecté Tableau à ClickHouse avec succès, et vous avez désormais accès à tout un monde de possibilités pour analyser et visualiser vos données ClickHouse.
## Installez le connecteur manuellement
Si vous utilisez une ancienne version de Tableau Desktop qui n’inclut pas le connecteur par défaut, vous pouvez l’installer manuellement en suivant ces étapes : 1. Téléchargez le fichier taco le plus récent depuis [Tableau Exchange](https://exchange.tableau.com/products/1064) 2. Placez le fichier taco dans * macOS : `~/Documents/My Tableau Repository/Connectors` * Windows : `C:\Users\[Windows User]\Documents\My Tableau Repository\Connectors` 3. Redémarrez Tableau Desktop ; si l’installation s’est bien déroulée, vous trouverez le connecteur dans la section `New Data Source`.
## Conseils de connexion et d’analyse
Pour plus de conseils sur l’optimisation de votre intégration Tableau-ClickHouse, veuillez consulter [Conseils de connexion](/fr/integrations/connectors/data-visualization/tableau/tableau-connection-tips) et [Conseils d’analyse](/fr/integrations/connectors/data-visualization/tableau/tableau-analysis-tips).
## Tests
Le connecteur est testé à l’aide du framework [TDVT](https://tableau.github.io/connector-plugin-sdk/docs/tdvt) et affiche actuellement un taux de couverture de 97 %.
## Résumé
Vous pouvez connecter Tableau à ClickHouse à l'aide du pilote ClickHouse ODBC/JDBC générique. Cependant, ce connecteur facilite la configuration de la connexion. Si vous rencontrez des problèmes avec ce connecteur, n'hésitez pas à nous contacter sur GitHub.