saiku

环境要求

• JDK（项目为 Java 编写，需本地可运行 java 命令）
• Apache Maven（需能执行 mvn 命令）
• Git（用于克隆仓库）
• 可访问 GitHub Packages 的凭证（README 提到本地构建存在认证问题，详见 CLAUDE.md）
• 建议预留 2GB 以上内存与磁盘空间用于构建与运行 fat-JAR

安装与启动步骤

1. 1克隆代码仓库

   从 GitHub 拉取 saiku 源码，命令结束后进入生成的 saiku 目录再执行后续构建。

   git clone https://github.com/spiculedata/saiku.git
   cd saiku

   复制

2. 2构建可运行 fat-JAR

   用 Maven 只构建 saiku-launcher 及其依赖模块，并跳过测试以加快构建；产物在 saiku-launcher/target 下。

   mvn -pl saiku-launcher -am -Dmaven.test.skip=true package

   复制

3. 3启动 Saiku 服务

   运行上一步生成的 fat-JAR，serve 子命令启动服务，用 --port 指定端口、--home 指定工作目录。

   java -jar saiku-launcher/target/saiku-*.jar serve --port 8080 --home ./saiku-home

   复制

4. 4浏览器访问体验

   服务启动后打开本机 8080 端口，即可在浏览器里拖拽分析 cube；也可先看官方在线 demo 对照效果。

5. 5（可选）跑集成测试

   该 profile 会在进程内启动 Jetty 与 launcher 的 WAR，并连到预置的 FoodMart H2 数据源，用于验证整套 API。

   mvn verify -P integration

   复制

关键配置

如何确认成功

启动命令无报错并停留在运行状态，浏览器访问 http://localhost:8080 能看到 Saiku 分析界面即成功；可对照 https://demo.saiku.bi 的界面。

常见问题

注意事项

• 官方 Docker 镜像地址为 ghcr.io/spiculedata/saiku，README 中仅以徽章形式给出，未提供具体 docker run 示例。
• 构建与依赖版本由 saiku-bom 统一管理，模块结构、依赖目录及本地构建注意事项见仓库内 CLAUDE.md。
• 项目许可证为 Apache-2.0 + EPL-1.0，商用前请确认授权条款。
• 遇到问题可到 GitHub Issues / Discussions 反馈，或加入 README 给出的 Slack 社区。