# Kettle (Pentaho Data Integration) 安装与使用指南
## 1. 软件准备
-
**Kettle (PDI CE)**: pdi-ce-8.2.0.0-342.zip
-
**JDK**: jdk-8u301-windows-x64.exe（Kettle 8 需 JDK 8 及以上）
### 下载说明
Kettle 原托管于 SourceForge，现已迁移至 pentaho。可搜索 "Pentaho Developer Edition" 下载最新版，或寻找历史版本镜像。
JDK 8 可从 openjdk 下载。
已传百度网盘,复制指令,打开APP,指令如下:
怆忾闻丽易莎邓書晨爵营手弋
## 2. 安装 Java 环境
### 目录规划
新建目录：
-
`D:\02Java\Java\jdk1.8.0_301`（存放 JDK）
-
`D:\02Java\Java\jre1.8.0_301`（存放 JRE）
### 安装步骤
-
运行 `jdk-8u301-windows-x64.exe`，安装时两次选择目录分别指向上述路径
-
在用户环境变量中添加：
-
`JAVA_HOME=D:\02Java\Java\jdk1.8.0_301`
-
`CLASSPATH=.;%JAVA_HOME%\lib;`
-
`PATH`：在原有值后追加 `;%JAVA_HOME%\bin`
> **注意**：多变量之间用英文分号 `;` 分隔，勿用中文分号。
### 验证安装
打开 CMD：
```cmd
java -version
javac
```
显示版本信息及 javac 帮助信息，说明安装成功。
## 3. 安装 Kettle
-
解压 `pdi-ce-8.2.0.0-342.zip`，得到 `data-integration` 文件夹
-
进入文件夹，找到 `Spoon.bat`，创建桌面快捷方式
-
将 `spoon.ico` 设置为快捷方式图标（可选）
-
配置环境变量 `KETTLE_HOME`：
- `KETTLE_HOME=D:\02ETL\kettle8\data-integration`
> **说明**：该变量指定 `.kettle` 配置文件夹的生成位置。未配置时，默认生成在用户家目录（如 `C:\Users\zgh`）。
双击 `Spoon.bat` 运行，首次启动较慢。建议将界面语言改为英文，便于搜索组件文档。
## 4. 常见问题
### 4.1 启动闪退
-
检查 JDK 版本是否符合要求（Kettle 8 对应 JDK 8）
-
检查 JDK 是否安装成功
-
调整 JVM 内存：编辑 `Spoon.bat` 中的 `PENTAHO_DI_JAVA_OPTIONS`
-
`-Xms1024m`：启动初始化内存
-
`-Xmx6144m`：最大使用内存
-
根据机器配置适当调整
-
更换低版本 Kettle（如 Kettle 5/6），旧硬件兼容性更好
### 4.2 中文乱码
使用资源库（Repository）存储元数据时，MySQL 可能出现中文乱码（Oracle 通常无此问题），建议尽量使用英文命名。
### 4.3 Excel 报错 file close
使用 `excel-output` 或 `excel-writer` 组件时报错，常见于 Kettle 5 + JDK 9 组合。升级至 Kettle 8.2 可解决。
### 4.4 其他问题
待补充...