# Connexion à Power BI

Dans cet article, nous expliquerons le processus de connexion de Microsoft Power BI à **IoT Query**. Pour rendre cela plus illustratif, nous construirons également un tableau de bord qui se connecte à la base de données analytique et surveille l’état en temps réel des véhicules, le tout en utilisant Microsoft Power BI.

{% hint style="info" %}
Ce guide fait partie de la **IoT Query** suite de documentation et couvre spécifiquement la connexion de Power BI à votre entrepôt de données. Si vous hésitez encore sur l’outil BI à utiliser, référez-vous à la [Sélection d'outils BI](https://www.navixy.com/docs/analytics/fr/iot-query/connection-setup/selecting-bi-tools) vue d’ensemble.
{% endhint %}

## Fonctionnalités du tableau de bord

* Afficher le nombre total de véhicules
* Visualiser les statuts de déplacement des véhicules (en mouvement/arrêté/garé)
* Visualiser les statuts de connexion (actif/inactif/hors ligne)
* Tableau détaillé avec le statut actuel de tous les véhicules
* Filtrage par type de véhicule, groupe, statut de mouvement et statut de connexion
* Possibilités d’exportation des données et des rapports

## Exigences techniques

* Windows 10/11 ou Windows Server 2016+
* Microsoft Power BI Desktop (version actuelle)
* Compte Microsoft pour l’accès à Power BI Service (optionnel)
* Minimum 4 Go de RAM (8 Go recommandés)
* Accès Internet pour la connexion à la base de données

## Installation et configuration

### 1. Installer Power BI Desktop

1. Téléchargez Power BI Desktop depuis le site officiel de Microsoft : <https://powerbi.microsoft.com/desktop/>
2. Exécutez l’installateur et suivez ses instructions.

### 2. Télécharger le fichier du tableau de bord

1. Téléchargez le [moving\_status\_dashboard.pbix](https://raw.githubusercontent.com/SquareGPS/bi-intergrations/main/power_bi/moving_status_dashboard.pbix) fichier depuis le [dépôt bi-intergrations](https://github.com/SquareGPS/bi-intergrations) -> `power_bi`. Vous pouvez cloner l’ensemble du dépôt pour d’autres interactions :

   ```sh
   git clone https://github.com/SquareGPS/bi-intergrations.git
   ```
2. Ouvrez le `moving_status_dashboard.pbix` fichier téléchargé en double-cliquant ou via le menu de Power BI Desktop : **Fichier → Ouvrir**.

## Connexion à la base de données

### 1. Mettre à jour les paramètres de connexion

1. Après avoir ouvert le fichier du tableau de bord, allez à **Transformer les données → Modifier les paramètres**.
2. Mettez à jour les paramètres suivants :

* `DB_HOST` - adresse du serveur de base de données
* `DB_NAME` - nom de la base de données
* `DB_USER` - nom d’utilisateur
* `DB_PASS` - mot de passe (ne pas enregistrer de fichiers contenant de vraies informations d’identification sur des accès partagés)
* `DB_PORT` - port de connexion (par défaut 5432)

3. Cliquez **OK** et appliquez les modifications.

#### Référence des paramètres de connexion

<table><thead><tr><th width="189.727294921875">Paramètre Lakehouse</th><th width="214.1817626953125">Emplacement du paramètre Power BI</th><th>Remarques</th></tr></thead><tbody><tr><td><strong>Hôte</strong></td><td><code>DB_HOST</code> paramètre</td><td>L’adresse du serveur de base de données fournie dans votre email de bienvenue</td></tr><tr><td><strong>Port</strong></td><td><code>DB_PORT</code> paramètre</td><td>Par défaut, 5432 pour PostgreSQL</td></tr><tr><td><strong>Nom de la base de données</strong></td><td><code>DB_NAME</code> paramètre</td><td>Le nom de base de données qui vous est attribué</td></tr><tr><td><strong>Nom d'utilisateur</strong></td><td><code>DB_USER</code> paramètre</td><td>Votre nom d'utilisateur de base de données</td></tr><tr><td><strong>Mot de passe</strong></td><td><code>DB_PASS</code> paramètre</td><td>Votre mot de passe de base de données sécurisé</td></tr><tr><td><strong>Mode SSL</strong></td><td>Paramètres de connexion</td><td>Définir sur <strong>require</strong> dans la boîte de dialogue Options</td></tr><tr><td><strong>Schéma</strong></td><td>Éditeur de requête</td><td>Spécifiez le schéma (<strong>raw_business_data</strong> ou <strong>raw_telematics_data</strong>) dans chaque requête</td></tr></tbody></table>

### 2. Configurer les informations d’identification

1. Lors de la première connexion, Power BI demandera les informations d’accès à la base de données.
2. Sélectionnez **Compte de base de données et mot de passe** comme type d’authentification.
3. Saisissez les informations d’identification fournies par votre administrateur.
4. Définir le niveau de confidentialité sur **Organisation** ou **Privé**.

## Utilisation du tableau de bord

Après avoir configuré la connexion, vous pouvez :

1. **Actualiser les données** - cliquez sur le **Actualiser** bouton du ruban ou utilisez le raccourci clavier Ctrl+R.
2. **Utiliser les filtres** - appliquez des filtres dans le panneau de droite ou directement sur les éléments du rapport :
   1. Filtrer par type de véhicule
   2. Filtrer par groupes
   3. Filtrer par statut de mouvement/connexion
3. **Approfondir les données** - cliquez sur les éléments de visualisation pour afficher des informations détaillées.
4. **Créer des signets** - enregistrez des paramètres et des vues de filtres spécifiques pour un accès rapide.

## Configuration de l’actualisation des données

### Actualisation locale

1. Dans Power BI Desktop, ouvrez le menu **Accueil → Actualiser**.
2. Pour configurer des actualisations régulières via Power BI Service, publiez le rapport sur Power BI Service.

### Actualisation cloud (Power BI Service)

1. (Optionnel) Publiez le tableau de bord sur Power BI Service en utilisant le **Publier** bouton dans Power BI Desktop.
2. Dans Power BI Service, allez dans les paramètres du jeu de données.
3. Dans la section **Actualisation planifiée** , configurez la fréquence d’actualisation.
4. Pour vous connecter à une base de données locale ou privée, vous devrez installer et configurer le Power BI Gateway.

## Dépannage

### Problèmes de connexion à la base de données

* **Erreur de connexion :** Vérifiez l’exactitude des informations d’identification et des paramètres de connexion.
* **Erreur de pare-feu :** Assurez-vous que votre adresse IP est ajoutée à la liste d’autorisation pour l’accès à la base de données.
* **Problèmes de passerelle :** Lors de l’utilisation de Power BI Gateway, vérifiez l’état du service de la passerelle.

### Problèmes de performance

* **Chargement lent des visualisations :**
  * Réduisez le nombre d’éléments affichés simultanément
  * Vérifiez le mode Importation/DirectQuery dans le modèle de données
* **Utilisation élevée de la mémoire :**
  * Réduisez la quantité de données importées en appliquant des filtres au niveau des requêtes
  * Supprimez les colonnes inutiles du modèle de données

### Autres problèmes

Voici quelques astuces qui peuvent vous aider à résoudre des problèmes courants :

1. Rouvrez Power BI Desktop et le fichier du tableau de bord
2. Vérifiez les mises à jour de Power BI Desktop
3. Réinstallez Power BI Desktop si nécessaire
4. Videz le cache de Power BI : **Fichier → Options → Global → Supprimer des éléments du cache**

## Étapes suivantes

Après avoir connecté avec succès Power BI à votre instance Private Telematics Lakehouse, nous vous recommandons de :

* Explorer les schémas de données disponibles en consultant la section [Aperçu du schéma](https://www.navixy.com/docs/analytics/fr/iot-query/schema-overview) pour mieux comprendre la structure et les relations des données.
* Commencez par des requêtes simples centrées sur des entités métier spécifiques avant de construire des tableaux de bord complexes - consultez nos [requêtes d’exemple](https://www.navixy.com/docs/analytics/fr/example-queries) à titre de référence.

### **Assistance**

Pour des questions techniques ou des demandes d’accès à la base de données de démonstration, veuillez contacter : <support@squaregps.com>