GaussDB 通过DBeaver连接实例

GaussDB 通过DBeaver连接实例

DBeaver是一个通用的数据库客户端，可以通过配置不同驱动连接各种不同的数据库。本章介绍如何通过DBeaver连接GaussDB实例。

获取驱动包和驱动包校验包。
根据不同版本的实例，下载对应版本的驱动包和驱动包校验包到本地任意目录，如表1所示。

校验驱动包。
为了防止驱动包在传递过程或存储期间被恶意篡改，需要对驱动包进行校验，校验方法如下：

使用快捷键“Win+R”打开“运行”窗口。 在“打开”栏，输入“cmd”，按“Enter”回车，打开命令行页面。
执行以下命令，获取驱动包的Hash值。

certutil -hashfile {驱动包本地目录}{驱动包名} sha256

{驱动包本地目录}：请根据实际下载目录进行替换。例如：C:\Users

{驱动包名}：请根据实际下载的驱动包名进行替换。例如：GaussDB_driver.zip

示例：certutil -hashfile C:\Users\GaussDB_driver.zip sha256

将2.b获取到的Hash值和1中获取到的驱动包校验包的Hash值进行比较。
若一致则通过校验。

若不一致，请重新下载驱动包，重复2.a~2.c进行校验。

解压驱动包，获取gsjdbc4.jar包。

将1中获取到的驱动包解压到本地， 根据您需要连接的实例类型，进入驱动包对应类型目录下的任意一个操作系统目录，找到GaussDB-Kernel_数据库版本号_操作系统版本号_64bit_Jdbc.tar.gz包后进行解压，获取到gsjdbc4.jar包，放在本地任意目录下。

例如：

需要连接分布式版实例，您可以进入到GaussDB_driver\Distributed\Euler2.5_X86_64路径下，找到GaussDB-Kernel_503.1.0.SPC2300_Euler_64bit_Jdbc.tar.gz包进行解压，获取到gsjdbc4.jar包。

说明：
JDBC驱动包不区分操作系统和架构。因此，在获取gsjdbc4.jar包时，只需要关注实例类型即可。

步骤二：获取DBeaver客户端安装包

DBeaver官网提供了针对不同操作系统的客户端安装包，单击此处访问DBeaver官网下载系统对应的DBeaver客户端安装包并完成安装 。

步骤三：创建新驱动

打开DBeaver客户端。
单击“数据库 > 驱动管理器”，打开驱动管理器界面。
单击“新建”，打开创建新驱动界面。

在“设置”页签中，正确输入驱动名称、类名、URL模板、默认端口、Default Database、Default User，选择驱动类型，单击“确定”创建驱动。

在“库”页签中，单击添加文件，选择步骤一第3步中的gsjdbc4.jar。
添加后驱动类为空，需要单击“找到类”，选择识别出来的驱动类。驱动类需要与“设置”页的“类名”一致。
单击“确定”，驱动设置完成。
步骤四：连接数据库
在DBeaver客户端单击，打开创建连接界面。
搜索步骤三中创建的驱动，选中驱动，单击“下一步”。

图1 选择驱动
点击放大
输入主机IP地址，端口，数据库名，用户名和密码。
表3 参数说明
单击“测试链接”。若弹框中显示“已连接”，则说明可正常连接，单击“确定”。
单击“完成”，即可连接到数据库。在“数据库导航”栏可查看到连接的数据库信息。

更多详情请参考GaussDB 文档中心：https://doc.hcs.huawei.com/db/zh-cn/gaussdbqlh/24.1.30/productdesc/qlh_03_0001.html