Dbeaver适配openGauss使用指导书

一、Dbeaver简介

Dbeaver是一个跨平台的数据库开发者工具，包括SQL编程，数据库管理和分析。它支持任意适配JDBC驱动的数据库系统。同时该工具也支持一些非JDBC的数据源，如MongoDB, Cassandra, Redis, DynamoDB等。

• 该工具提供了许多强大的特性，诸如元数据编辑器、SQL编辑器、富文本数据编辑器、ERD、数据导入/导出/迁移，SQL执行计划等；

• 该工具基于eclipse平台开发；

• 适配的数据库有MySQL/MariaDB, PostgreSQL, Greenplum, Oracle, DB2 LUW, Exasol, SQL Server, Sybase/SAP ASE, SQLite, Firebird, H2, HSQLDB, Derby, Teradata, Vertica, Netezza, Informix等。

二、Dbeaver下载

Dbeaver是一款开源软件，代码托管在github上：

源代码下 载 : https://github.com/dbeaver/dbeaver.

此处可以直接下载二进制文件:

https://github.com/dbeaver/dbeaver/releases.

三、依赖包下载

1. Dbeaver依赖jre 1.8及以上 (请自行下载或前往: https://adoptopenjdk.net/?variant=openjdk8&jvmVariant=hotspot.）

备注:免安装版必须安装jre, windows installer版本已经自带jre.

2.下载openGauss JDBC驱动到本地

从opengauss.org官网获取: https://opengauss.org/zh/download.html.

四、Dbeaver配置

1. 启动Dbeaver.exe，并选择菜单->数据库->驱动管理器，在弹出对话框中，选择新建:

2. 添加JDBC驱动

a. 填写新建驱动名称->选择JDBC驱动文件->选择JDBC Driver类，如下图：

b. 填写URL模板，值为: jdbc:postgresql://{host}:{port}/{database} ，然后勾选嵌入，其他复选框不选择，然后确认，添加驱动即完成，如下图:

五、Dbeaver连接

1. 选择菜单->数据库->新建连接， 在弹出的框中搜索上一步中新建的JDBC驱动名,选择后点击下一步,如下图示:

2. 在弹出框中填写openGauss 主机地址、端口、将要连接的数据库以及认证用户名和密码，点击测试链接验证是否可正确连接，如图示：

3. 测试结果OK后点击确认，并点击完成，则连接成功

4. 左边的导航栏即可见数据库已经连接成功

六、Dbeaver使用

SQL编写:选中要使 用的数据库，并按下F3(或使用菜单->SQL编辑器->SQL编辑器)即可打开SQL编写器，可以在编辑器中编写SQL和执行。

其他功能使用和其他客户端工具相似，请自行探索。

七、常见问题

1. Javax.xml.bind.DatatypeConverter转换出错，如下图

**解决方法 *: 本地安装的java版本无javax.xml.bind.jar 这个包， 可以在添加JDBC驱动jar包时额外增加此包: https://mvnrepository.com/artifact/javax.xml.bind/jaxb-api/2.2.2

也可以使用maven下载:

<!--https://mvnrepository.com/artifact/javax.xml.bind/jaxb-api --> <dependency> <groupId>javax.xml.bind</groupId> <artifactId>jaxb-api</artifactId> <version>2.2.2</version> </dependency>.

2. 提示No suitable driver found for jdbc:postgresql://xxx

解决方法:在添加JDBC驱动时不要勾选 ‘Use legacy JDBC instantiation’:

openGauss开源社区官方网站：

https://opengauss.org

openGauss组织仓库：

https://gitee.com/opengauss

openGauss镜像仓库：

https://github.com/opengauss-mirror

你的一个 “点赞、分享、在看”

让我们之间的距离又近了一步

本文分享自微信公众号 - openGauss（openGauss）。
如有侵权，请联系 support@oschina.cn 删除。
本文参与“ OSC源创计划 ”，欢迎正在阅读的你也加入，一起分享。