# Laboratorio Pentaho en Windows {% hint style="info" %} #### **Laboratorio Pentaho** Pentaho Data Integration es una herramienta basada en cliente comúnmente instalada y configurada para ejecutarse en Windows 11. Existen varias opciones de licencia; para estos talleres instalaremos una Edición Empresarial. Esto te dará la oportunidad de probar la construcción de una solución completa: canalizaciones de datos automatizadas + analítica .. {% endhint %}

{% hint style="danger" %} Los siguientes pasos están destinados a configurar un entorno de Laboratorio Pentaho y deben completarse para finalizar los talleres. Asegúrate de haber descargado Workshop--Installation ``` cd \ git clone https://github.com/jporeilly/Workshop--Installation ``` {% endhint %} {% tabs %} {% tab title="Docker Desktop" %} {% hint style="info" %} #### Docker Desktop Docker Desktop es una aplicación para Windows, macOS y Linux que proporciona una interfaz fácil de usar para desarrollar y ejecutar aplicaciones en contenedores. Agrupa el Docker Engine, Docker CLI, Docker Compose, Kubernetes y otras herramientas esenciales en un solo paquete con una interfaz gráfica de usuario. Docker Desktop simplifica la gestión de contenedores al manejar automáticamente la virtualización subyacente, permitiendo a los desarrolladores construir, probar y desplegar aplicaciones en contenedores aislados y portátiles sin preocuparse por las diferencias de configuración del entorno. Es particularmente popular entre desarrolladores que quieren garantizar que sus aplicaciones se ejecuten de forma coherente en distintos entornos, desde máquinas de desarrollo locales hasta servidores de producción. {% endhint %} {% embed url="" %} 1. Descarga el instalador de Docker Desktop. {% embed url="" %} Enlace para descargar Docker Desktop {% endembed %} 2. Navega a: Descargas 3. Haz doble clic: `Docker Desktop Installer.exe` para ejecutar el instalador. Por defecto, Docker Desktop se instala en `C:\Program Files\Docker\Docker`. {% hint style="danger" %} Cuando se te solicite, asegúrate de que la **Usar WSL 2 en lugar de Hyper-V** opción en la página de Configuración esté seleccionada. En sistemas que solo admiten un backend, Docker Desktop selecciona automáticamente la opción disponible. {% endhint %}

3. Cerrar para completar el proceso de instalación. *** {% hint style="info" %} #### **Usuario de Docker** Si tu cuenta de administrador es diferente a tu cuenta de usuario, debes agregar el usuario al grupo docker-users: {% endhint %} 1. Ejecuta Administración de equipos como administrador. 2. Navega a **Usuarios y grupos locales** > **Grupos** > **docker-users**. 3. Haz clic derecho para agregar el usuario al grupo.

4. Cierra la sesión y vuelve a iniciarla para que los cambios surtan efecto. {% endtab %} {% tab title="Contenedor MySQL" %} {% hint style="info" %} #### **Docker Compose - MySQL** El usuario pentaho\_admin solo tiene permiso de LECTURA para la base de datos Steel Wheels - sampledata. La cuenta de administrador ha sido eliminada. Como vas a realizar operaciones CRUD en la base de datos, necesitamos desplegar una base de datos sampledata en un contenedor Docker, otorgando todos los privilegios a un usuario administrador. {% endhint %} {% file src="" %} {% file src="" %} {% file src="" %} 1. Ejecuta el siguiente script para crear una carpeta MySQL y copiar los archivos necesarios. ```ps1 cd \ cd C:\Workshop--Installation\MySQL .\copy-mysql.ps1 ``` 2. Verifica que el directorio se haya creado y que los archivos se hayan copiado. 3. Ejecuta el script docker-compose para crear el contenedor. ```powershell cd \ cd C:\MySQL .\run-docker-mysql.ps1 ```

4. Comprueba que el contenedor esté activo y en funcionamiento en Docker Desktop.

{% endtab %} {% tab title="sampledata" %} {% hint style="info" %} #### **Sampledata** A continuación en la lista está crear la base de datos sampledata. {% endhint %}

{% tabs %} {% tab title="1. sampledata\_schema.sql" %} {% hint style="info" %} #### **sampledata\_schema.sql** Este script crea una estructura de base de datos relacional completa para una aplicación de negocio de ejemplo. Está diseñado para modelar un sistema de ventas y gestión de pedidos para una empresa que vende varios productos. {% endhint %} {% hint style="info" %} #### **Configuración de la base de datos** * Crea una base de datos llamada ``` sampledata ``` con conjunto de caracteres UTF-8 * Configura usuarios con permisos apropiados * Configura el modo SQL para una mejor integridad de los datos {% endhint %} {% hint style="info" %} #### **Tablas** **OFICINAS**: Almacena ubicaciones de oficinas de la empresa con detalles de la dirección **EMPLEADOS**: Contiene información de empleados con relaciones a oficinas y estructura de reportes **CLIENTES**: Almacena información de clientes incluyendo detalles de contacto y límites de crédito **PRODUCTOS**: Contiene el catálogo de productos con inventario e información de precios **PEDIDOS**: Rastrea pedidos de clientes con estado y fechas **DETALLES\_PEDIDO**: Contiene las líneas de cada pedido con cantidad y precio **PAGOS**: Registra pagos de clientes con montos y fechas **FACT\_PEDIDO**: Una tabla de hechos para analítica de pedidos **CLIENTE\_CON\_TER**: Información extendida del cliente con territorio **DIM\_TIEMPO**: Tabla dimensión tiempo para informes **GERENTES\_DEPARTAMENTO**: Almacena información de gerentes de departamento **CUADRANTE\_REALES**: Contiene datos financieros de presupuesto vs. reales con una columna VARIANCE generada **BALANCE\_DE\_COMPROBACIÓN**: Datos contables financieros {% endhint %} {% hint style="info" %} #### **Vistas** **resumen\_pedidos\_cliente**: Resume pedidos y gastos por cliente **rendimiento\_producto**: Analiza métricas de ventas de productos incluyendo ingresos y beneficio **rendimiento\_ventas\_empleado**: Rastrea el rendimiento de ventas por empleado **tendencia\_ventas\_mensual**: Muestra tendencias de ventas a lo largo del tiempo por mes **estado\_inventario\_producto**: Categoriza productos por niveles de inventario **historial\_pagos\_cliente**: Resume la actividad de pagos y saldos de clientes {% endhint %} {% hint style="info" %} #### **Procedimientos almacenados** **ObtenerPedidosCliente**: Recupera pedidos para un cliente específico **ActualizarStockProducto**: Actualiza los niveles de inventario de productos **ObtenerVentasProductoPorTrimestre**: Analiza las ventas de productos por trimestre **ObtenerMejoresClientesPorRegión**: Identifica los mejores clientes por región **ObtenerValorInventarioPorLíneaProducto**: Calcula métricas de inventario por línea de producto **Disparadores** **antes\_insertar\_pedido**: Valida restricciones de fecha en pedidos **antes\_insertar\_pago**: Asegura que los montos de pago sean positivos {% endhint %} {% hint style="info" %} #### **Eventos** * **mantenimiento\_diario**: Tarea programada para mantenimiento de la base de datos {% endhint %} 1. Ejecuta el siguiente comando para crear el esquema. ```powershell cd \ cd MySQL Get-Content sampledata_schema.sql | docker exec -i mysql-database-1 mysql -u root -p"password" sampledata ``` {% hint style="info" %} Este comando está importando datos del esquema SQL a una base de datos MySQL que se ejecuta en un contenedor Docker. Aquí hay un desglose: Este comando lee el archivo SQL: ```powershell Get-Content sampledata_schema.sql ``` Envía (redirige) el contenido del archivo al siguiente comando: ``` | ``` Esto ejecuta un comando en un contenedor Docker en ejecución: ``` docker exec -i mysql-database-1 mysql -u root -p"password" sampledata ``` {% endhint %} 2. Puedes comprobar la base de datos sampledata y las tablas con los siguientes comandos. Mostrar bases de datos: ```powershell docker exec -i mysql-database-1 mysql -u root -p"password" -e "SHOW DATABASES;" ``` Mostrar tablas: ```powershell docker exec -i mysql-database-1 mysql -u root -p"password" sampledata -e "SHOW TABLES;" ``` Mostrar columnas de la tabla: ```powershell docker exec -i mysql-database-1 mysql -u root -p"password" sampledata -e "DESCRIBE table_name;" ```

{% endtab %} {% tab title="2. sampledata\_data.sql" %} {% hint style="info" %} #### **sampledata\_data.sql** Este script pobla la base de datos con datos de ejemplo para demostrar la funcionalidad del esquema. {% endhint %} {% hint style="info" %} #### **Datos de referencia** * Ubicaciones de oficinas en diferentes regiones * Jerarquía de empleados con cargos * Catálogo de productos organizado por líneas de producto {% endhint %} {% hint style="info" %} #### **Datos transaccionales** * Registros de clientes con información de contacto * Historial de pedidos con fechas y estado * Detalles de pedidos con cantidades y precios * Registros de pagos {% endhint %} {% hint style="info" %} #### **Datos financieros** * Cifras de presupuesto vs. reales en CUADRANTE\_REALES * Datos contables de balance de comprobación {% endhint %} {% hint style="info" %} #### **Características de los datos** * Escenarios comerciales realistas con estados de pedidos variados * Catálogo de productos completo con descripciones y precios * Estructura jerárquica de empleados con relaciones de reporte * Datos basados en el tiempo que abarcan varios años para análisis de tendencias * Datos financieros adecuados para presupuestos y análisis de variaciones {% endhint %} {% hint style="info" %} #### **Características notables** * Los datos siguen restricciones de integridad referencial * Manejo adecuado de valores NULL cuando corresponde * Precios y cantidades realistas * Las columnas generadas (como VARIANCE) están excluidas de inserciones directas * Los pedidos están secuenciados para satisfacer las restricciones de claves foráneas {% endhint %} 1. Ejecuta el siguiente comando para cargar los datos en las tablas sampledata. ```powershell cd \ cd MySQL Get-Content sampledata_data.sql | docker exec -i mysql-database-1 mysql -u root -p"password" sampledata ``` 2. Puedes usar los siguientes comandos para comprobar que los datos se han cargado. Para contar el número de filas en una tabla específica: ```docker docker exec -i mysql-database-1 mysql -u root -p"password" sampledata -e "SELECT COUNT(*) FROM table_name;" ``` Para ver las primeras filas de una tabla: ```docker docker exec -i mysql-database-1 mysql -u root -p"password" sampledata -e "SELECT * FROM table_name LIMIT 10;" ``` Para comprobar los conteos de todas las tablas: ```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';" ``` Para obtener un resumen de las tablas y sus estados: ```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 Vas a necesitar una herramienta de gestión de bases de datos. DBeaver Community es una herramienta gratuita y de código abierto para la gestión de bases de datos para proyectos personales. {% endhint %} 1. Ve al oficial [página de descarga de DBeaver](https://dbeaver.io/download/) {% embed url="" %} 2. Navega a Descargas y haz doble clic en: `dbeaver-ce-25.2.5-x86_64-setup.exe` 3. Sigue las instrucciones de instalación. 4. Sigue las instrucciones en pantalla, haciendo clic en "Siguiente" y aceptando el acuerdo de licencia para continuar. 5. Elige las opciones de instalación deseadas (por ejemplo, para todos los usuarios o el usuario actual).

6. Completa el proceso de instalación. *** {% hint style="info" %} #### **Base de datos MySQL** Si has completado los 3 requisitos anteriores, deberías tener un contenedor MySQL en Docker, expuesto en el puerto:3306 con la base de datos sampledata. {% endhint %} 1. Inicia DBeaver y selecciona: MySQL.

2. Configura la conexión con las siguientes propiedades: Nombre de usuario: root o pentaho\_user Contraseña: password

Configurar y probar la conexión MySQL - sampledata

{% hint style="warning" %} Puede que necesites descargar la versión compatible del driver de la base de datos. También habilita: allowPublicKeyRetrieval {% endhint %}

3. Prueba la conexión.

4. Expande: databases > sampledata > Tables

5. Abre una ventana SQL y ejecuta una consulta de prueba. ```sql select * from CUSTOMERS where COUNTRY = 'USA' and CITY = 'NYC'; ```

{% endtab %} {% endtabs %}