> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-55d9d317.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
> Microsoft Power BI est un logiciel de visualisation de données interactif développé par Microsoft, principalement dédié à la business intelligence.
# Power BI
export const ClickHouseSupportedBadge = () => {
return
Compatible avec ClickHouse
;
};
export const Image = ({img, alt, size}) => {
return
;
};
Microsoft Power BI peut interroger les données de [ClickHouse Cloud](https://clickhouse.com/cloud) ou d’un déploiement autogéré, ou les charger en mémoire.
Il existe plusieurs versions de Power BI que vous pouvez utiliser pour visualiser vos données :
* Power BI Desktop : une application de bureau Windows pour créer des tableaux de bord et des visualisations
* Power BI Service : disponible dans Azure sous forme de SaaS pour héberger les tableaux de bord créés avec Power BI Desktop
Power BI nécessite que vous créiez vos tableaux de bord dans la version Desktop, puis que vous les publiiez dans Power BI Service.
Ce tutoriel vous guidera à travers les étapes suivantes :
* [Installation du pilote ODBC ClickHouse](#install-the-odbc-driver)
* [Installation du connecteur ClickHouse Power BI dans Power BI Desktop](#power-bi-installation)
* [Interrogation des données de ClickHouse pour les visualiser dans Power BI Desktop](#query-and-visualise-data)
* [Configuration d’une passerelle de données locale pour Power BI Service](#power-bi-service)
## Prérequis
### Installation de Power BI
Ce tutoriel suppose que Microsoft Power BI Desktop est installé sur votre ordinateur Windows. Vous pouvez télécharger et installer Power BI Desktop [ici](https://www.microsoft.com/en-us/download/details.aspx?id=58494)
Nous vous recommandons de mettre Power BI à jour vers la dernière version. Le ClickHouse Connector est disponible par défaut à partir de la version `2.137.751.0`.
### Rassemblez les informations de connexion de votre instance ClickHouse
Vous aurez besoin des informations suivantes pour vous connecter à votre instance ClickHouse :
* Nom d’hôte - ClickHouse
* Nom d’utilisateur - Identifiants de l’utilisateur
* Mot de passe - Mot de passe de l’utilisateur
* Base de données - Nom de la base de données de l’instance à laquelle vous souhaitez vous connecter
## Power BI Desktop
Pour commencer à interroger les données dans Power BI Desktop, vous devez suivre les étapes suivantes :
1. Installez le pilote ODBC ClickHouse
2. Recherchez le ClickHouse Connector
3. Connectez-vous à ClickHouse
4. Interrogez et visualisez vos données
### Installer le pilote ODBC
Téléchargez la dernière [version du pilote ODBC ClickHouse](https://github.com/ClickHouse/clickhouse-odbc/releases).
Exécutez le programme d’installation `.msi` fourni et suivez l’assistant.
Les `Debug symbols` sont facultatifs et ne sont pas nécessaires
#### Vérifier le pilote ODBC
Une fois l’installation du pilote terminée, vous pouvez vérifier qu’elle s’est bien déroulée comme suit :
recherchez ODBC dans le menu Démarrer, puis sélectionnez « ODBC Data Sources **(64-bit)** ».
Vérifiez que le pilote ClickHouse figure bien dans la liste.
### Trouver le ClickHouse Connector
Disponible dans la version `2.137.751.0` de Power BI Desktop
Dans l’écran de démarrage de Power BI Desktop, cliquez sur « Get Data ».
Recherchez « ClickHouse »
### Se connecter à ClickHouse
Sélectionnez le connecteur, puis saisissez les identifiants de l’instance ClickHouse :
* Host (obligatoire) - Le domaine/l’adresse de votre instance. Veillez à l’ajouter sans préfixe ni suffixe.
* Port (obligatoire) - Le port de votre instance.
* Database - Le nom de votre base de données.
* Options - Toute option ODBC, comme indiqué
sur la [page GitHub ODBC de ClickHouse](https://github.com/ClickHouse/clickhouse-odbc#configuration)
* Mode de connectivité des données - DirectQuery
Nous vous conseillons de sélectionner DirectQuery pour interroger ClickHouse directement.
Si votre cas d’usage porte sur un faible volume de données, vous pouvez choisir le mode Import, et l’ensemble des données sera chargé dans Power BI.
* Indiquez le nom d’utilisateur et le mot de passe
### Interroger et visualiser les données
Enfin, vous devriez voir les bases de données et les tables dans la vue Navigator. Sélectionnez la table souhaitée et cliquez sur "Load" pour
importer les données depuis ClickHouse.
Une fois l'importation terminée, vos données ClickHouse devraient être accessibles dans Power BI comme à l'accoutumée.
## Power BI Service
Pour utiliser Microsoft Power BI Service, vous devez créer une [passerelle de données locale](https://learn.microsoft.com/en-us/power-bi/connect-data/service-gateway-onprem).
Pour en savoir plus sur la configuration des connecteurs personnalisés, consultez la documentation de Microsoft sur la façon d’[utiliser des connecteurs de données personnalisés avec une passerelle de données locale](https://learn.microsoft.com/en-us/power-bi/connect-data/service-gateway-custom-connectors).
## Pilote ODBC (importation uniquement)
Nous vous recommandons d’utiliser le ClickHouse Connector avec DirectQuery.
Installez le [Pilote ODBC](#install-the-odbc-driver) sur l’instance de la passerelle de données locale et [vérifiez](#verify-odbc-driver) comme décrit ci-dessus.
### Créer un nouveau DSN utilisateur
Une fois l’installation du pilote terminée, vous pouvez créer une source de données ODBC. Recherchez ODBC dans le menu Démarrer et sélectionnez « ODBC Data Sources (64-bit) ».
Ajoutez ici un nouveau DSN utilisateur. Cliquez sur le bouton « Add » à gauche.
Choisissez la version Unicode du pilote ODBC.
Renseignez les informations de connexion.
Si vous utilisez un déploiement avec SSL activé (par exemple ClickHouse Cloud ou une instance autogérée), vous devez indiquer `require` dans le champ `SSLMode`.
* `Host` doit toujours être renseigné sans le protocole (c.-à-d. sans `http://` ou `https://`).
* `Timeout` est un entier représentant un nombre de secondes. Valeur par défaut : `30 seconds`.
### Importer des données dans Power BI
Si vous n'avez pas encore installé Power BI,
[téléchargez et installez Power BI Desktop](https://www.microsoft.com/en-us/download/details.aspx?id=58494).
Sur l'écran de démarrage de Power BI Desktop, cliquez sur "Get Data".
Sélectionnez "Other" -> "ODBC".
Sélectionnez la source de données que vous avez créée précédemment dans la liste.
Si vous n'avez pas indiqué d'identifiants lors de la création de la source de données, vous serez invité à renseigner un nom d'utilisateur et un mot de passe.
Enfin, vous devriez voir les bases de données et les tables dans la vue Navigator. Sélectionnez la table souhaitée, puis cliquez sur "Load" pour importer les données depuis ClickHouse.
Une fois l'importation terminée, les données ClickHouse devraient être accessibles dans Power BI comme d'habitude.
## Optimiser le travail avec de grands jeux de données
PowerBI est conçu pour les bases de données relationnelles traditionnelles avec des volumes de données modérés. Lorsque vous utilisez ClickHouse à grande échelle (des milliards de lignes), des schémas d'architecture spécifiques sont nécessaires pour obtenir des performances optimales.
PowerBI génère automatiquement des requêtes SQL avec des sous-requêtes imbriquées, des jointures complexes et des transformations à la volée. Ces schémas fonctionnent bien avec les bases de données SQL traditionnelles, mais peuvent s'avérer inefficaces lors de l'interrogation de bases de données columnaires à grande échelle comme ClickHouse.
**Approche recommandée pour les grands jeux de données :** au lieu d'interroger directement les tables brutes, créez des `vues matérialisées` dédiées dans ClickHouse pour chaque visualisation de tableau de bord. Cela vous permet de bénéficier de :
* Performances rapides et constantes, quel que soit le volume de données
* Charge réduite sur votre cluster ClickHouse
* Coûts plus prévisibles
Si vos tableaux de bord sont lents, consultez le [`query_log`](/fr/reference/system-tables/query_log) de ClickHouse pour voir quelles requêtes SQL Power BI exécute réellement. Les problèmes les plus fréquents incluent des sous-requêtes imbriquées, le balayage de tables entières ou des jointures inefficaces. Une fois le problème identifié, créez des [vues matérialisées](/fr/concepts/features/materialized-views/index) qui répondent précisément à ces problèmes.
### Bonnes pratiques d’implémentation
#### Stratégie de pré-agrégation
Créez des vues matérialisées à plusieurs niveaux d’agrégation :
* Des agrégations horaires pour des tableaux de bord récents et détaillés
* Des agrégations quotidiennes pour les tendances historiques
* Des rollups mensuels pour les rapports à long terme
* Conservez les données brutes avec un TTL approprié pour des analyses ad hoc
#### Optimisation de la modélisation des données
* Définissez des clés `ORDER BY` adaptées à vos schémas de requêtes
* Utilisez le partitionnement pour les données de séries temporelles
* Convertissez les petites tables de dimensions en dictionnaires pour des recherches efficaces
* Tirez parti des projections pour optimiser davantage les requêtes
## Limites connues
### UInt64
Les types d'entiers non signés tels que UInt64 ou supérieurs ne sont pas chargés automatiquement dans le jeu de données, car Int64 est le plus grand type de nombre entier pris en charge par Power BI.
Pour importer correctement les données, avant de cliquer sur le bouton "Load" dans le Navigator, cliquez d'abord sur "Transform Data".
Dans cet exemple, la table `pageviews` comporte une colonne UInt64, reconnue par défaut comme "Binary".
"Transform Data" ouvre le Power Query Editor, où il est possible de réattribuer le type de la colonne, en la définissant par exemple comme
Text.
Une fois l'opération terminée, cliquez sur "Close & Apply" dans le coin supérieur gauche, puis poursuivez le chargement des données.