Connexion à Apache Superset

Dans cet article, nous expliquerons le processus de connexion d'Apache Superset à la base de données analytique. Pour rendre cela plus illustratif, nous construirons également un tableau de bord connecté à la base de données analytique et surveillerons l'état en temps réel des véhicules, le tout en utilisant Apache Superset.

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 vue d’ensemble.

Fonctionnalités du tableau de bord

• Afficher le nombre total d'objets

• 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

• Notifications et alertes personnalisables

Exigences techniques

• Docker et Docker Compose

• Minimum 4 Go de RAM (8 Go recommandés)

• 20 Go d'espace disque libre

• Linux/Windows avec WSL2/macOS

• Python 3.8+

• Accès Internet pour la connexion à la base de données

Installation et configuration

1. Installation avec Docker (méthode recommandée)

1. Installez Docker et Docker Compose en suivant la documentation officielle :

• Installation de Docker

• Installation de Docker Compose

1. Téléchargez le fichier docker-compose officiel :

curl -fL https://raw.githubusercontent.com/apache/superset/master/docker-compose-non-dev.yml -o docker-compose.yml

1. Démarrez Superset :

docker-compose up -d

1. Créez un administrateur :

docker-compose exec superset superset fab create-admin \
  --username admin \
  --firstname Superset \
  --lastname Admin \
  --email [email protected] \
  --password admin

1. Initialisez la base de données :

docker-compose exec superset superset db upgrade

1. Chargez les exemples et initialisez les rôles :

docker-compose exec superset superset init

2. Installation avec pip (pour le développement)

1. Créez un environnement virtuel :

python -m venv venv
source venv/bin/activate  # pour Linux/macOS
# ou
.\venv\Scripts\activate  # pour Windows

1. Installez Superset :

pip install apache-superset

1. Initialisez la base de données :

superset db upgrade

1. Créez un administrateur :

export FLASK_APP=superset
superset fab create-admin

1. Chargez les exemples et initialisez les rôles :

superset init

1. Démarrez Superset :

superset run -p 8088 --with-threads --reload --debugger

Connexion à la base de données

1. Connectez-vous à Superset (par défaut : http://localhost:8088)

2. Naviguez vers Data → Databases

3. Cliquez sur "+" pour ajouter une nouvelle base de données

4. Remplissez les paramètres de connexion :

   1. Base de données : PostgreSQL

   2. URI SQLAlchemy : postgresql://${DB_USER}:${DB_PASS}@${DB_HOST}:${DB_PORT}/${DB_NAME}

   3. Nom d'affichage : Analytics Database

   4. Extra : {"engine_params": {"connect_args": {"sslmode": "require"}}}

5. Cliquez Tester la connexion pour vérifier la connexion

6. Enregistrez les paramètres

Référence des paramètres de connexion

Paramètre Lakehouse	Emplacement du paramètre dans Apache Superset	Remarques
Hôte	DB_HOST dans l'URI SQLAlchemy	L’adresse du serveur de base de données fournie dans votre email de bienvenue
Port	DB_PORT dans l'URI SQLAlchemy	Par défaut, 5432 pour PostgreSQL
Nom de la base de données	DB_NAME dans l'URI SQLAlchemy	Le nom de base de données qui vous est attribué
Nom d'utilisateur	DB_USER dans l'URI SQLAlchemy	Votre nom d'utilisateur de base de données
Mot de passe	DB_PASS dans l'URI SQLAlchemy	Votre mot de passe de base de données sécurisé
Mode SSL	connect_args dans les paramètres Extra	Définir sur require dans la configuration JSON Extra
Schéma	Configuration du jeu de données	Spécifiez le schéma (raw_business_data ou raw_telematics_data) dans chaque jeu de données

Importation du tableau de bord et des graphiques

1. Clonez le bi-integratons dépôt :

git clone https://github.com/SquareGPS/bi-intergrations.git

1. Dans Superset, allez à Settings → Import/Export

2. Importez les fichiers dans l'ordre suivant :

   1. datasets.json - datasets

   2. charts.json - charts

   3. dashboards.json - dashboards

3. Après l'importation, mettez à jour les connexions de base de données dans chaque jeu de données

Dépannage

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

• Erreur de connexion : Vérifiez l'exactitude des identifiants et des paramètres de connexion

• Erreur de pare-feu : Assurez-vous que votre adresse IP est ajoutée à la liste d'autorisation

• Problèmes SSL : Vérifiez les paramètres SSL dans les paramètres de connexion

Problèmes de performance

• Chargement lent des visualisations :

  • Optimisez les requêtes SQL

  • Réduisez le nombre d’éléments affichés simultanément

  • Utilisez la mise en cache des résultats

• Utilisation élevée de la mémoire :

  • Augmentez les ressources des conteneurs Docker

  • Optimisez les requêtes de la base de données

Autres problèmes

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

1. Vérifiez les logs de Superset :

docker-compose logs superset

1. Redémarrez les conteneurs :

docker-compose restart

1. Videz le cache du navigateur

2. Vérifiez la version de Superset et mettez à jour si nécessaire

Étapes suivantes

Après avoir connecté Power BI à votre IoT Query instance, nous vous recommandons de :

• Explorer les schémas de données disponibles en consultant la section Aperçu du schéma 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 à 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 : [email protected]