# kettle-dm-database-plugin

**Repository Path**: knqiufan/kettle-dm-database-plugin

## Basic Information

- **Project Name**: kettle-dm-database-plugin
- **Description**: kettle 的达梦数据库连接插件
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-22
- **Last Updated**: 2025-07-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Kettle 达梦数据库插件

[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
[![Java](https://img.shields.io/badge/Java-8+-orange.svg)](https://www.oracle.com/java/)
[![Kettle](https://img.shields.io/badge/Kettle-9.4.0.0-green.svg)](https://pentaho.com/)

这是一个为 Pentaho Data Integration (Kettle) 开发的达梦数据库连接插件，支持在 Kettle 中直接连接和操作达梦数据库。

## 功能特性

- ✅ 支持达梦数据库 8.x 版本
- ✅ 完整的 JDBC 连接支持
- ✅ 支持原生连接和 JNDI 连接方式
- ✅ 兼容 Kettle 9.4.0.0 版本
- ✅ 支持标准 SQL 操作
- ✅ 支持数据库元数据查询
- ✅ 支持存储过程调用

## 系统要求

- **Java**: JDK 8 或更高版本
- **Kettle**: Pentaho Data Integration 9.4.0.0 或兼容版本
- **达梦数据库**: DM 8.x 版本
- **操作系统**: Windows, Linux, macOS

## 快速开始

### 1. 下载插件

从 [Releases](../../releases) 页面下载最新版本的插件包 `dm-database-plugin-1.0.0.0.zip`。

### 2. 安装插件

1. 解压下载的插件包
2. 将解压后的文件复制到 Kettle 安装目录的 `plugins` 文件夹下
3. 重启 Kettle

```bash
# 示例安装路径
kettle-installation-dir/
├── plugins/
│   └── dm-database-plugin/
│       ├── dm-database-plugin-1.0.0.0.jar
│       └── lib/
│           ├── DmJdbcDriver18-8.1.2.192.jar
│           └── ... (其他依赖库)
```

### 3. 配置数据库连接

1. 在 Kettle 中创建新的数据库连接
2. 选择数据库类型为 "DM"
3. 配置连接参数：
   - **主机名**: 达梦数据库服务器地址
   - **端口**: 默认 5236
   - **数据库名**: 数据库实例名
   - **用户名**: 数据库用户名
   - **密码**: 数据库密码

### 4. 测试连接

点击"测试连接"按钮验证配置是否正确。

## 构建说明

### 前置条件

- Maven 3.6+
- JDK 8+
- 达梦数据库 JDBC 驱动

### 编译步骤

1. 克隆项目到本地：
```bash
git clone <repository-url>
cd dm-database-plugin
```

2. 安装达梦 JDBC 驱动到本地 Maven 仓库：
```bash
mvn install:install-file -Dfile=path/to/DmJdbcDriver18.jar \
    -DgroupId=com.dameng -DartifactId=DmJdbcDriver18 \
    -Dversion=8.1.2.192 -Dpackaging=jar
```

3. 编译项目：
```bash
mvn clean compile
```

4. 打包插件：
```bash
mvn clean package
```

编译完成后，在 `target` 目录下会生成 `dm-database-plugin-1.0.0.0.zip` 文件。

## 部署到 Kettle

### 方法一：手动部署

1. 解压生成的 zip 文件
2. 将内容复制到 Kettle 的 `plugins` 目录
3. 重启 Kettle

### 方法二：自动部署脚本

```bash
#!/bin/bash
# 设置 Kettle 安装路径
KETTLE_HOME="/path/to/kettle"
PLUGIN_DIR="$KETTLE_HOME/plugins/dm-database-plugin"

# 创建插件目录
mkdir -p "$PLUGIN_DIR"

# 复制插件文件
unzip -o target/dm-database-plugin-1.0.0.0.zip -d "$PLUGIN_DIR"

echo "插件部署完成，请重启 Kettle"
```

## 配置说明

### 连接 URL 格式

```
jdbc:dm://hostname:port/database
```

### 支持的连接类型

- **原生连接**: 使用达梦 JDBC 驱动直接连接
- **JNDI 连接**: 通过应用服务器的 JNDI 数据源连接

### 驱动类名

```
dm.jdbc.driver.DmDriver
```

## 故障排除

### 常见问题

1. **连接失败**
   - 检查达梦数据库服务是否启动
   - 验证网络连接和防火墙设置
   - 确认用户名密码正确

2. **驱动未找到**
   - 确保 DmJdbcDriver18.jar 在插件的 lib 目录中
   - 检查 Kettle 是否正确加载了插件

3. **版本兼容性**
   - 确认 Kettle 版本为 9.4.0.0 或兼容版本
   - 检查达梦数据库版本是否为 8.x

### 日志调试

启用 Kettle 的调试日志来排查问题：

```bash
# 在 Kettle 启动参数中添加
-Dlog4j.configuration=file:log4j.xml -Dlog4j.debug=true
```

## 贡献指南

欢迎提交 Issue 和 Pull Request 来改进这个插件。

### 开发环境设置

1. Fork 项目
2. 创建功能分支
3. 提交更改
4. 创建 Pull Request

## 许可证

本项目采用 [Apache License 2.0](LICENSE) 许可证。

## 联系方式

- 作者: knqiufan
- 版本: 1.0.0.0
- 更多信息: [达梦数据库官网](http://www.dameng.com)

## 更新日志

### v1.0.0.0 (2024-11-27)
- 初始版本发布
- 支持达梦数据库 8.x 连接
- 兼容 Kettle 9.4.0.0
- 支持基本的数据库操作功能