diff --git a/content/zh/post/justbk/2020-10-30_dbeaver_for_openGauss.md b/content/zh/post/justbk/2020-10-30_dbeaver_for_openGauss.md new file mode 100644 index 0000000000000000000000000000000000000000..adc23ed2282f9aa4e336ad6ff56a12c19ac1f459 --- /dev/null +++ b/content/zh/post/justbk/2020-10-30_dbeaver_for_openGauss.md @@ -0,0 +1,99 @@ ++++ +title = "Dbeaver适配openGauss使用指导书" +date = "2020-10-30" +tags = ["openGauss社区开发入门"] +archives = "2020-10" +author = "justbk" +summary = "openGauss社区开发入门" +img="/zh/post/justbk/title/title.png" +times = "17:30" + ++++ + +## 一、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，并选择菜单->数据库->驱动管理器，在弹出对话框中，选择新建: + +![image-20201031160917008](../img/驱动器管理.png "驱动器管理") + +### 2. 添加JDBC驱动 +#### a. 填写新建驱动名称->选择JDBC驱动文件->选择JDBC Driver类，如下图： + +![image-20201031161118343](../img/JDBC_Driver驱动.png "JDBC_Driver驱动") + +#### b. 填写URL模板，值为: jdbc:postgresql://{host}:{port}/{database} ，然后勾选嵌入，其他复选框不选择，然后确认，添加驱动即完成，如下图: + +![image-20201031161200535](../img/url模板.png "url模板") + +## 五、Dbeaver连接 + +### 1. 选择菜单->数据库->新建连接， 在弹出的框中搜索上一步中新建的JDBC驱动名,选择后点击下一步,如下图示: + +![image-20201031161304090](../img/新建连接.png "新建连接") + +### 2. 在弹出框中填写openGauss 主机地址、端口、将要连接的数据库以及认证用户名和密码，点击测试链接验证是否可正确连接，如图示： + +![image-20201031161348486](../img/通用JDBC连接设置.png "通用JDBC连接设置") + +### 3. 测试结果OK后点击确认，并点击完成，则连接成功 + +![image-20201031161423966](../img/测试连接成功.png "测试连接成功") + +### 4. 左边的导航栏即可见数据库已经连接成功 + +![image-20201031161451687](../img/数据库连接成功.png "数据库连接成功") + +## 六、Dbeaver使用 + +SQL编写:选中要使用的数据库，并按下F3(或使用菜单->SQL编辑器->SQL编辑器)即可打开SQL编写器，可以在编辑器中编写SQL和执行。 + +![image-20201031161524533](../img/SQL编辑.png "SQL编辑") + +其他功能使用和其他客户端工具相似，请自行探索。 + +## 七、常见问题 + +### 1. Javax.xml.bind.DatatypeConverter转换出错，如下图 + +![image-20201031161628317](../img/converter转换出错.png "converter转换出错") + +**解决方法 **: 本地安装的java版本无javax.xml.bind*.jar这个包， 可以在添加JDBC驱动jar包时额外增加此包:[链接](https://mvnrepository.com/artifact/javax.xml.bind/jaxb-api/2.2.2)。 + +也可以使用maven下载: + +` + + javax.xml.bind + jaxb-api + 2.2.2 +` + +### 2. 提示No suitable driver found for jdbc:postgresql://xxx + +![image-20201031164019085](../img/NoSuiteDriver.png "NoSuiteDriver") + +**解决方法**:在添加JDBC驱动时不要勾选 ‘Use legacy JDBC instantiation’: + +![image-20201031164050597](../img/不要勾选legacy_jdbc.png "不要勾选legacy_jdbc") diff --git "a/content/zh/post/justbk/img/JDBC_Driver\351\251\261\345\212\250.png" "b/content/zh/post/justbk/img/JDBC_Driver\351\251\261\345\212\250.png" new file mode 100644 index 0000000000000000000000000000000000000000..3a4d5e6193e37394152f6a322d2c063347cf47c5 Binary files /dev/null and "b/content/zh/post/justbk/img/JDBC_Driver\351\251\261\345\212\250.png" differ diff --git a/content/zh/post/justbk/img/NoSuiteDriver.png b/content/zh/post/justbk/img/NoSuiteDriver.png new file mode 100644 index 0000000000000000000000000000000000000000..9654c56e62596234e74ee1d0fe4323f03056346c Binary files /dev/null and b/content/zh/post/justbk/img/NoSuiteDriver.png differ diff --git "a/content/zh/post/justbk/img/SQL\347\274\226\350\276\221.png" "b/content/zh/post/justbk/img/SQL\347\274\226\350\276\221.png" new file mode 100644 index 0000000000000000000000000000000000000000..2cc96fbc17e8b5f50dbf6d5d65579170e78fa61c Binary files /dev/null and "b/content/zh/post/justbk/img/SQL\347\274\226\350\276\221.png" differ diff --git "a/content/zh/post/justbk/img/converter\350\275\254\346\215\242\345\207\272\351\224\231.png" "b/content/zh/post/justbk/img/converter\350\275\254\346\215\242\345\207\272\351\224\231.png" new file mode 100644 index 0000000000000000000000000000000000000000..fd37a349daabb46a95616faf3c9f369588f04e64 Binary files /dev/null and "b/content/zh/post/justbk/img/converter\350\275\254\346\215\242\345\207\272\351\224\231.png" differ diff --git "a/content/zh/post/justbk/img/url\346\250\241\346\235\277.png" "b/content/zh/post/justbk/img/url\346\250\241\346\235\277.png" new file mode 100644 index 0000000000000000000000000000000000000000..1a8813e9734b78779b7bac0c6c50ab21d6c5f9a4 Binary files /dev/null and "b/content/zh/post/justbk/img/url\346\250\241\346\235\277.png" differ diff --git "a/content/zh/post/justbk/img/\344\270\215\350\246\201\345\213\276\351\200\211legacy_jdbc.png" "b/content/zh/post/justbk/img/\344\270\215\350\246\201\345\213\276\351\200\211legacy_jdbc.png" new file mode 100644 index 0000000000000000000000000000000000000000..28b09b8751541d26b13a238c20ceb9e639007243 Binary files /dev/null and "b/content/zh/post/justbk/img/\344\270\215\350\246\201\345\213\276\351\200\211legacy_jdbc.png" differ diff --git "a/content/zh/post/justbk/img/\346\225\260\346\215\256\345\272\223\350\277\236\346\216\245\346\210\220\345\212\237.png" "b/content/zh/post/justbk/img/\346\225\260\346\215\256\345\272\223\350\277\236\346\216\245\346\210\220\345\212\237.png" new file mode 100644 index 0000000000000000000000000000000000000000..1f18abb182df7a8f9c8432ddcf67bcb971de0d6e Binary files /dev/null and "b/content/zh/post/justbk/img/\346\225\260\346\215\256\345\272\223\350\277\236\346\216\245\346\210\220\345\212\237.png" differ diff --git "a/content/zh/post/justbk/img/\346\226\260\345\273\272\350\277\236\346\216\245.png" "b/content/zh/post/justbk/img/\346\226\260\345\273\272\350\277\236\346\216\245.png" new file mode 100644 index 0000000000000000000000000000000000000000..4c00ea6043a95996cdbfdd4bde3bef58556cc6c7 Binary files /dev/null and "b/content/zh/post/justbk/img/\346\226\260\345\273\272\350\277\236\346\216\245.png" differ diff --git "a/content/zh/post/justbk/img/\346\265\213\350\257\225\350\277\236\346\216\245\346\210\220\345\212\237.png" "b/content/zh/post/justbk/img/\346\265\213\350\257\225\350\277\236\346\216\245\346\210\220\345\212\237.png" new file mode 100644 index 0000000000000000000000000000000000000000..5152f5c83b68920ef8f750b77bdee8c1d24abb91 Binary files /dev/null and "b/content/zh/post/justbk/img/\346\265\213\350\257\225\350\277\236\346\216\245\346\210\220\345\212\237.png" differ diff --git "a/content/zh/post/justbk/img/\351\200\232\347\224\250JDBC\350\277\236\346\216\245\350\256\276\347\275\256.png" "b/content/zh/post/justbk/img/\351\200\232\347\224\250JDBC\350\277\236\346\216\245\350\256\276\347\275\256.png" new file mode 100644 index 0000000000000000000000000000000000000000..441e784650c72af7e42ebac3f5ec6e8add2a0c84 Binary files /dev/null and "b/content/zh/post/justbk/img/\351\200\232\347\224\250JDBC\350\277\236\346\216\245\350\256\276\347\275\256.png" differ diff --git "a/content/zh/post/justbk/img/\351\251\261\345\212\250\345\231\250\347\256\241\347\220\206.png" "b/content/zh/post/justbk/img/\351\251\261\345\212\250\345\231\250\347\256\241\347\220\206.png" new file mode 100644 index 0000000000000000000000000000000000000000..ebd32d0e536ad21b7bb125d8322ee98f63379607 Binary files /dev/null and "b/content/zh/post/justbk/img/\351\251\261\345\212\250\345\231\250\347\256\241\347\220\206.png" differ diff --git a/content/zh/post/justbk/title/title.png b/content/zh/post/justbk/title/title.png new file mode 100644 index 0000000000000000000000000000000000000000..a4406314f319001be395f4ddf2e532ced8932f69 Binary files /dev/null and b/content/zh/post/justbk/title/title.png differ