# Laboratoire Pentaho Windows {% hint style="info" %} #### **Laboratoire Pentaho** Pentaho Data Integration est un outil côté client couramment installé et configuré pour fonctionner sous Windows 11. Il existe plusieurs options de licence ; pour ces ateliers nous installerons une édition Enterprise. Cela vous donnera l'occasion d'essayer de construire une solution complète - pipelines de données automatisés + analyses .. {% endhint %}

{% hint style="danger" %} Les étapes suivantes sont destinées à configurer un environnement Laboratoire Pentaho et doivent être complétées afin de terminer les ateliers. Assurez-vous d'avoir téléchargé l'atelier--Installation ``` cd \ git clone https://github.com/jporeilly/Workshop--Installation ``` {% endhint %} {% tabs %} {% tab title="Docker Desktop" %} {% hint style="info" %} #### Docker Desktop Docker Desktop est une application pour Windows, macOS et Linux qui fournit une interface facile à utiliser pour développer et exécuter des applications conteneurisées. Elle regroupe le Docker Engine, le Docker CLI, Docker Compose, Kubernetes et d'autres outils essentiels dans un seul package avec une interface graphique. Docker Desktop simplifie la gestion des conteneurs en gérant automatiquement la virtualisation sous-jacente, permettant aux développeurs de construire, tester et déployer des applications dans des conteneurs isolés et portables sans se soucier des différences de configuration d'environnement. Il est particulièrement populaire parmi les développeurs qui souhaitent s'assurer que leurs applications s'exécutent de manière cohérente sur différents environnements, de la machine de développement locale aux serveurs de production. {% endhint %} {% embed url="" %} 1. Téléchargez le programme d'installation de Docker Desktop. {% embed url="" %} Lien pour télécharger Docker Desktop {% endembed %} 2. Accédez à : Téléchargements 3. Double-cliquez : `Docker Desktop Installer.exe` pour exécuter le programme d'installation. Par défaut, Docker Desktop est installé à `C:\Program Files\Docker\Docker`. {% hint style="danger" %} Lorsque vous y êtes invité, assurez-vous que **Utiliser WSL 2 au lieu de Hyper-V** l'option sur la page de configuration est sélectionnée. Sur les systèmes qui ne prennent en charge qu'un seul backend, Docker Desktop sélectionne automatiquement l'option disponible. {% endhint %}

3. Fermer pour terminer le processus d'installation. *** {% hint style="info" %} #### **Utilisateur Docker** Si votre compte administrateur est différent de votre compte utilisateur, vous devez ajouter l'utilisateur au groupe docker-users : {% endhint %} 1. Exécutez Gestion de l'ordinateur en tant qu'administrateur. 2. Accédez à **Utilisateurs et groupes locaux** > **Groupes** > **docker-users**. 3. Cliquez avec le bouton droit pour ajouter l'utilisateur au groupe.

4. Déconnectez-vous et reconnectez-vous pour que les modifications prennent effet. {% endtab %} {% tab title="Conteneur MySQL" %} {% hint style="info" %} #### **Docker Compose - MySQL** L'utilisateur pentaho\_admin n'a que l'autorisation LECTURE pour la base de données Steel Wheels - sampledata. Le compte administrateur a été supprimé. Comme vous allez effectuer des opérations CRUD sur la base de données, nous devons déployer une base de données sampledata - conteneur Docker, en accordant tous les privilèges à un utilisateur admin. {% endhint %} {% file src="" %} {% file src="" %} {% file src="" %} 1. Exécutez le script suivant pour créer un dossier MySQL et copier les fichiers requis. ```ps1 cd \ cd C:\Workshop--Installation\MySQL .\copy-mysql.ps1 ``` 2. Vérifiez que le répertoire a été créé et que les fichiers ont été copiés. 3. Exécutez le script docker-compose pour créer le conteneur. ```powershell cd \ cd C:\MySQL .\run-docker-mysql.ps1 ```

4. Vérifiez que le conteneur est opérationnel dans Docker Desktop.

{% endtab %} {% tab title="sampledata" %} {% hint style="info" %} #### **Données d'exemple** La prochaine étape consiste à créer la base de données sampledata. {% endhint %}

{% tabs %} {% tab title="1. sampledata\_schema.sql" %} {% hint style="info" %} #### **sampledata\_schema.sql** Ce script crée une structure de base de données relationnelle complète pour une application métier d'exemple. Il est conçu pour modéliser un système de gestion des ventes et des commandes pour une entreprise qui vend divers produits. {% endhint %} {% hint style="info" %} #### **Configuration de la base de données** * Crée une base de données nommée ``` sampledata ``` avec l'encodage de caractères UTF-8 * Met en place des utilisateurs avec les permissions appropriées * Configure le mode SQL pour une meilleure intégrité des données {% endhint %} {% hint style="info" %} #### **Tables** **BUREAUX**: Stocke les emplacements des bureaux de l'entreprise avec les détails d'adresse **EMPLOYÉS**: Contient des informations sur les employés avec des relations aux bureaux et à la structure hiérarchique **CLIENTS**: Stocke les informations client incluant les coordonnées et les limites de crédit **PRODUITS**: Contient le catalogue de produits avec les informations d'inventaire et de tarification **COMMANDES**: Suit les commandes des clients avec le statut et les dates **DETAILS\_COMMANDE**: Contient les lignes d'articles pour chaque commande avec quantité et prix **PAIEMENTS**: Enregistre les paiements des clients avec montants et dates **FACT\_COMMANDE**: Une table de faits pour l'analyse des commandes **CLIENT\_AVEC\_TER**: Informations client étendues avec territoire **DIM\_TEMPS**: Table dimensionnelle de temps pour les rapports **RESPONSABLES\_DEPARTEMENT**: Stocke les informations des responsables de département **QUADRANT\_REELS**: Contient les données financières budget vs réel avec une colonne VARIANCE générée **BALANCE\_DE\_VERSEMENT**: Données de comptabilité financière {% endhint %} {% hint style="info" %} #### **Vues** **résumé\_commandes\_client**: Résume les commandes et les dépenses par client **performance\_produit**: Analyse les métriques de ventes des produits incluant revenus et bénéfices **performance\_ventes\_employé**: Suit la performance des ventes par employé **tendance\_ventes\_mensuelle**: Montre les tendances des ventes dans le temps par mois **statut\_inventaire\_produit**: Catégorise les produits par niveaux d'inventaire **historique\_paiements\_client**: Résume l'activité de paiement des clients et les soldes {% endhint %} {% hint style="info" %} #### **Procédures stockées** **ObtenirCommandesClient**: Récupère les commandes d'un client spécifique **MettreAJourStockProduit**: Met à jour les niveaux d'inventaire des produits **ObtenirVentesProduitParTrimestre**: Analyse les ventes trimestrielles par produit **ObtenirTopClientsParRégion**: Identifie les meilleurs clients par région **ObtenirValeurInventaireParLigneProduit**: Calcule les métriques d'inventaire par ligne de produit **Triggers** **avant\_insertion\_commande**: Valide les contraintes de date sur les commandes **avant\_insertion\_paiement**: S'assure que les montants des paiements sont positifs {% endhint %} {% hint style="info" %} #### **Événements** * **maintenance\_quotidienne**: Tâche planifiée pour la maintenance de la base de données {% endhint %} 1. Exécutez la commande suivante pour créer le schéma. ```powershell cd \ cd MySQL Get-Content sampledata_schema.sql | docker exec -i mysql-database-1 mysql -u root -p"password" sampledata ``` {% hint style="info" %} Cette commande importe des données de schéma SQL dans une base de données MySQL s'exécutant dans un conteneur Docker. Voici une répartition : Cette commande lit le fichier SQL : ```powershell Get-Content sampledata_schema.sql ``` Transmet (redirige) le contenu du fichier à la commande suivante : ``` | ``` Ceci exécute une commande dans un conteneur Docker en cours d'exécution : ``` docker exec -i mysql-database-1 mysql -u root -p"password" sampledata ``` {% endhint %} 2. Vous pouvez vérifier la base de données sampledata et les tables avec les commandes suivantes. Afficher les bases de données : ```powershell docker exec -i mysql-database-1 mysql -u root -p"password" -e "SHOW DATABASES;" ``` Afficher les tables : ```powershell docker exec -i mysql-database-1 mysql -u root -p"password" sampledata -e "SHOW TABLES;" ``` Afficher les colonnes d'une table : ```powershell docker exec -i mysql-database-1 mysql -u root -p"password" sampledata -e "DESCRIBE table_name;" ```

Vérifier la base de données et les tables

{% endtab %} {% tab title="2. sampledata\_data.sql" %} {% hint style="info" %} #### **sampledata\_data.sql** Ce script peuple la base de données avec des données d'exemple pour démontrer la fonctionnalité du schéma. {% endhint %} {% hint style="info" %} #### **Données de référence** * Emplacements des bureaux à travers différentes régions * Hiérarchie des employés avec intitulés de postes * Catalogue de produits organisé par lignes de produits {% endhint %} {% hint style="info" %} #### **Données transactionnelles** * Enregistrements clients avec informations de contact * Historique des commandes avec dates et statuts * Détails des commandes avec quantités et prix * Enregistrements de paiements {% endhint %} {% hint style="info" %} #### **Données financières** * Chiffres budget vs réel dans QUADRANT\_REELS * Données de comptabilité de balance de vérification {% endhint %} {% hint style="info" %} #### **Caractéristiques des données** * Scénarios commerciaux réalistes avec divers statuts de commande * Catalogue de produits complet avec descriptions et tarification * Structure hiérarchique des employés avec relations de reporting * Données temporelles couvrant plusieurs années pour l'analyse des tendances * Données financières adaptées à la budgétisation et à l'analyse des écarts {% endhint %} {% hint style="info" %} #### **Caractéristiques notables** * Les données respectent les contraintes d'intégrité référentielle * Bonne gestion des valeurs NULL lorsque c'est approprié * Valeurs de prix et de quantités réalistes * Les colonnes générées (comme VARIANCE) sont exclues des insertions directes * Les commandes sont séquencées pour satisfaire les contraintes de clé étrangère {% endhint %} 1. Exécutez la commande suivante pour charger les données dans les tables sampledata. ```powershell cd \ cd MySQL Get-Content sampledata_data.sql | docker exec -i mysql-database-1 mysql -u root -p"password" sampledata ``` 2. Vous pouvez utiliser les commandes suivantes pour vérifier que les données ont été chargées. Pour compter le nombre de lignes dans une table spécifique : ```docker docker exec -i mysql-database-1 mysql -u root -p"password" sampledata -e "SELECT COUNT(*) FROM table_name;" ``` Pour voir les premières lignes d'une table : ```docker docker exec -i mysql-database-1 mysql -u root -p"password" sampledata -e "SELECT * FROM table_name LIMIT 10;" ``` Pour vérifier les comptes pour toutes les tables : ```docker docker exec -i mysql-database-1 mysql -u root -p"password" sampledata -e "SELECT TABLE_NAME, TABLE_ROWS FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_SCHEMA = 'sampledata';" ``` Pour obtenir un résumé des tables et de leur statut : ```docker docker exec -i mysql-database-1 mysql -u root -p"password" sampledata -e "SHOW TABLE STATUS;" ```

{% endtab %} {% endtabs %} {% endtab %} {% tab title="DBeaver" %} {% hint style="info" %} #### DBeaver Vous allez avoir besoin d'un outil de gestion de base de données. DBeaver Community est un outil de gestion de base de données gratuit et open-source pour les projets personnels. {% endhint %} 1. Allez sur le site officiel [page de téléchargement de DBeaver](https://dbeaver.io/download/) {% embed url="" %} 2. Accédez à Téléchargements et double-cliquez sur : `dbeaver-ce-25.2.5-x86_64-setup.exe` 3. Suivez les instructions d'installation. 4. Suivez les instructions à l'écran, cliquez sur « Suivant » et acceptez le contrat de licence pour continuer. 5. Choisissez vos options d'installation souhaitées (par ex., pour tous les utilisateurs ou l'utilisateur actuel).

6. Terminez le processus d'installation. *** {% hint style="info" %} #### **Base de données MySQL** Si vous avez rempli les 3 exigences précédentes, vous devriez avoir un conteneur MySQL Docker, exposé sur le port :3306 avec la base de données sampledata. {% endhint %} 1. Lancez DBeaver et sélectionnez : MySQL.

2. Configurez la connexion avec les propriétés suivantes : Nom d'utilisateur : root ou pentaho\_user Mot de passe : password

Configurer et tester la connexion MySQL - sampledata

{% hint style="warning" %} Vous devrez peut-être télécharger la version du pilote de base de données prise en charge. Activez également : allowPublicKeyRetrieval {% endhint %}

3. Testez la connexion.

4. Développez : bases de données > sampledata > Tables

5. Ouvrez une fenêtre SQL et exécutez une requête de test. ```sql select * from CUSTOMERS where COUNTRY = 'USA' and CITY = 'NYC'; ```

{% endtab %} {% endtabs %}