OceanBase分Oracle租户模式和mysql租户模式。目前DBeaver默认提供的 OceanBase 驱动是连接 MySQL 租户的,想连接 Oracle 租户则需要自己新建一个驱动器使用。
1. 确认驱动JAR文件
- 下载正确的驱动:
OceanBase的JDBC驱动可能因版本不同而变化。建议从以下渠道获取最新驱动:- OceanBase官方GitHub:
OceanBase JDBC驱动 - Maven仓库:搜索
oceanbase-client(如oceanbase-client-x.x.x.jar)。
- OceanBase官方GitHub:

- 验证驱动类名:
较新版本的OceanBase JDBC驱动可能使用以下类名:com.oceanbase.jdbc.Driver
2. 重新配置DBeaver驱动
- 打开驱动管理器
- 在DBeaver中,进入:
数据库→驱动管理器。 - 找到或新建一个驱动(如
OceanBase Oracle)。
- 在DBeaver中,进入:

- 更新驱动配置
- 驱动类名:改为
com.oceanbase.jdbc.Driver。 - URL模板:
- 驱动类名:改为
jdbc:oceanbase://{host}:{port}/{database}

- 添加驱动JAR文件
- 点击
添加文件,选择下载的OceanBase JDBC驱动JAR(如oceanbase-client-2.4.0.jar)。 - 确保JAR文件路径正确,且无其他冲突的驱动文件。
- 点击

点击确定
3. 检查依赖冲突
- 移除旧版驱动:
如果之前添加了旧版驱动(如ojdbc8.jar),建议暂时移除,避免类名冲突。 - 清理DBeaver缓存:
重启DBeaver或清理缓存(菜单:帮助→清理缓存)。
4. 测试连接
- 新建连接
- 进入菜单:
数据库→新建连接。或者一般左上角加号。 - 选择配置好的
OceanBase Oracle驱动。
- 进入菜单:

- 填写连接信息
- 主机:OceanBase Proxy或集群IP。
- 端口:
2883(默认Oracle模式端口)。 - 用户名:
用户名@租户名#集群名(如admin@oboracle#obdemo)。 - 密码:用户密码。

- 测试连接
- 点击
测试连接,确认是否成功。
- 点击

5. 其他注意的问题
- 网络问题:
确保DBeaver可以访问OceanBase集群的IP和端口(如2883)。 - 驱动版本兼容性:
确认JDBC驱动版本与OceanBase服务器版本匹配(如OceanBase 3.x/4.x)。 - 日志排查:
查看DBeaver日志(菜单:窗口→显示视图→错误日志)获取详细错误信息。
6. 其他配置方式
- 在自己创建驱动管理器的时候,也可以在驱动类型选择通用的数据库连接驱动。不使用oceanbase驱动类型。

此时再连接时也可以连接成功。
填写信息也是相同数据
