DBeaver 与 Excel JDBC 驱动(xlSql)使用说明

项目地址github: https://github.com/daichangya/xlsql
1. 概述

本文档详细介绍了如何在 DBeaver 中配置和使用 Excel JDBC 驱动来连接和操作 Excel 文件。Excel JDBC 驱动允许用户像操作数据库一样查询和修改 Excel 文件中的数据。
2. 准备工作

2.1 系统要求

• Java 8 或更高版本
  
• DBeaver 21.0 或更高版本
  
• Excel JDBC 驱动 JAR 文件
  

2.2 获取 Excel JDBC 驱动

方式一：从 Maven Central 获取（推荐）

XLSQL 5.1.1 已发布到 Maven Central，可以直接通过 Maven 依赖使用：

1. <dependency>
2.     <groupId>io.github.daichangya</groupId>
3.     xlsql</artifactId>
4.     <version>5.1.1</version>
5. </dependency>

复制代码

方式二：手动下载 JAR 文件

从 Maven Central 下载：

• 标准 JAR: https://repo1.maven.org/maven2/io/github/daichangya/xlsql/5.1.1/xlsql-5.1.1.jar
  
• Shaded JAR (包含所有依赖): https://repo1.maven.org/maven2/io/github/daichangya/xlsql/5.1.1/xlsql-5.1.1-shaded.jar
  

3. 在 DBeaver 中配置 Excel JDBC 驱动

3.1 打开驱动管理器

• 启动 DBeaver
  
• 点击菜单栏 Database → Driver Manager
  

3.2 创建新驱动

• 点击 New 按钮创建新驱动
  
• 在 Settings 标签页中填写以下信息：
  
  
  
  • Driver Name: Excel JDBC Driver
    
  • Class Name: io.github.daichangya.xlsql.jdbc.xlDriver
    
  • URL Template: jdbc:xlsql:excel:{path}
    
  • Port: (留空)
    
  
  

3.3 添加驱动文件

• 切换到 Libraries 标签页
  
• 点击 Add File 按钮
  
• 选择你的 Excel JDBC 驱动 JAR 文件
  
  
  
  • 路径示例：/path/to/xlsql-5.1.1.jar
    
  
  
• 点击 OK 保存驱动配置
  

4. 创建数据库连接

4.1 新建连接

• 点击 Database → New Database Connection
  
• 在连接类型列表中选择 Generic → Generic JDBC
  
• 点击 Next
  

4.2 配置连接参数

• Driver: 选择之前创建的 "Excel JDBC Driver"
  
• JDBC URL: 输入 Excel 文件路径
  1. jdbc:xlsql:excel:/path

  复制代码
  示例：
  1. jdbc:xlsql:excel:/Users/username/Documents

  复制代码

4.3 测试连接

• 点击 Test Connection 按钮
  
• 如果配置正确，会显示 "Connected" 消息
  
• 点击 Finish 完成连接创建
  

5. 使用 Excel JDBC 驱动

5.1 浏览数据结构

连接成功后，你可以在 DBeaver 的数据库导航器中看到：

• Excel 文件作为数据库显示
  
• 每个工作表作为数据表显示
  
• 表的列对应 Excel 中的第一行标题
  

5.2 执行 SQL 查询

在 SQL 编辑器中可以执行标准 SQL 查询：（使用下划线格式，表名和字段名无需引号）

1. -- 查询所有数据（使用下划线格式，无需引号）
2. SELECT * FROM test1_Sheet1;
4. -- 条件查询
5. SELECT * FROM test1_Sheet1 WHERE column1 = 'value';
7. -- 聚合查询
8. SELECT COUNT(*) FROM test1_Sheet1;
10. -- 排序查询
11. SELECT * FROM test1_Sheet1 ORDER BY column1;

复制代码

6. Excel 文件要求

6.1 文件格式

• 支持 .xls``.xlsx 格式
  

6.2 工作表结构

• 第一行为列标题
  
• 标题应使用有效的 SQL 标识符
  
• 避免使用特殊字符和空格
  
• 每列应保持数据类型一致
  

6.3 示例 Excel 结构

1. | Name    | Age | City      |
2. |---------|-----|-----------|
3. | John    | 25  | New York  |
4. | Jane    | 30  | Los Angeles |

复制代码

7. 常见问题和解决方案

7.1 连接失败

问题: Cannot invoke "String.length()" because "" is null
解决方案:

• 检查 JDBC URL 中的文件路径是否正确
  
• 确保 Excel 文件存在且可访问
  

7.2 驱动未找到

问题: Driver class not found
解决方案:

• 确认驱动 JAR 文件已正确添加到驱动配置中
  
• 检查驱动类名是否正确：io.github.daichangya.xlsql.jdbc.xlDriver
  

7.3 权限问题

问题: Permission denied 访问 Excel 文件
解决方案:

• 检查文件权限
  
• 确保 DBeaver 进程有读写文件的权限
  

7.4 中文字符乱码

解决方案:

• 确保 Excel 文件使用 UTF-8 编码
  
• 在连接参数中指定字符集
  

8. 高级配置

8.1 连接属性

可以在连接配置中设置以下属性：

• charset: 指定字符集编码
  
• readonly: 设置只读模式
  

8.2 性能优化

• 对于大型 Excel 文件，建议使用过滤条件减少数据加载
  
• 避免在复杂公式的工作表上执行查询
  

9. 限制和注意事项

9.1 功能限制

• 不支持复杂的数据类型（如图片、图表等）
  
• 不支持 Excel 公式计算
  
• 对大型文件的性能可能较差
  
• 并发访问支持有限
  

9.2 数据类型映射

Excel 类型SQL 类型文本VARCHAR数字NUMERIC日期DATE布尔值BOOLEAN9.3 最佳实践

• 定期备份重要的 Excel 文件
  
• 在执行写操作前确认文件未被其他程序占用
  
• 避免在生产环境中直接修改原始数据文件
  
• 使用副本文件进行测试操作
  

10. 故障排除

10.1 日志查看

• 在 DBeaver 中打开 Window → Show View → Error Log
  
• 查看详细错误信息
  

10.2 启用调试模式

在启动 DBeaver 时添加调试参数：

1. dbeaver -vmargs -Dorg.jkiss.dbeaver.debug=true

复制代码

10.3 联系支持

如果遇到无法解决的问题，请提供：

• 完整的错误日志
  
• 使用的 Excel 文件示例
  
• DBeaver 和驱动版本信息
  

11. 版本兼容性

DBeaver 版本Excel JDBC 驱动版本兼容性21.x5.1.1✓22.x5.1.1✓12. 更新日志

版本 5.1.1

• 初始版本
  
• 支持基本的 CRUD 操作
  
• 支持 .xls .xlsx 格式文件
  
• 与 DBeaver 集成
  

注意: 本文档基于 Excel JDBC 驱动版本 5.1.1 编写，具体功能可能因版本更新而有所变化。建议在使用前确认当前版本的功能特性。

来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！