telefonicaiot/pentaho-dsp

Pentaho Dynamic Schema Processor

概述

pentaho-dsp是一个扩展Pentaho功能的库，核心作用是允许重用Mondrian模式以访问数据库的不同模式，通过动态替换数据库模式为Pentaho会话的用户名实现灵活访问。此外，该项目可构建包含OpenJDK 11及Pentaho 9 CE所有依赖（含本库代码）的Docker基础镜像，简化Pentaho相关应用的部署。

核心功能与特性

库功能

• 扩展Pentaho：支持重用Mondrian模式访问数据库的不同模式
• 动态替换：自动将数据库模式替换为当前Pentaho会话的用户名

Docker镜像特性

• 基础环境：基于OpenJDK 11构建
• 依赖集成：包含运行Pentaho 9 CE所需的全部依赖
• 配置脚本：内置两个定制化配置脚本（位于hooks目录）：
  • pentaho-dsp.sh：确保pentaho-dsp.jar版本与Pentaho卷中库兼容
  • url-auth.sh：支持在iframe中嵌入Pentaho部件

使用场景与适用范围

• 适用于需要通过Pentaho访问多数据库模式的场景，简化模式切换管理
• 作为开发或部署依赖Pentaho 9 CE应用的基础Docker镜像，提供统一运行环境

使用方法与配置说明

构建JAR文件

通过以下Maven命令生成.jar文件：

1. mvn initialize
2. mvn clean
3. mvn compile
4. mvn clean package

目录说明

• lib：存储Maven仓库中未包含的开发必需库副本
• src：包含Java源代码
• hooks：存储Docker镜像的配置脚本

版本发布流程

使用Github Actions自动构建JAR文件，发布新版本步骤如下：

1. 修改pom.xml中<version>属性的版本号：

   xml
   <version>A.B.C</version>
   

2. 提交并推送更改
3. 创建与版本号一致的git标签：

   bash
   git tag -a A.B.C -m "Versión A.B.C"
   git push --tags
   

   注意：版本号与标签名称必须一致，以确保自动构建成功。

Docker镜像使用

构建镜像

使用以下命令构建Docker镜像：

bash
docker build --rm -t pentaho-env:latest .

查看使用说明

构建完成后，通过以下命令查看镜像使用说明：

bash
docker run --rm pentaho-env:latest cat /opt/usage.txt