通过DBeaver连接实例

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

本章节以DBeaver 24.1.4版本为例提供连接指导。因DBeaver不同版本的操作界面可能不同，如需了解其他版本的操作，请参考对应版本的DBeaver产品文档。

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

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

步骤二：连接数据库

在DBeaver客户端单击，打开创建连接界面。
在SQL页签中，选择GaussDB数据库，单击“下一步”。
图1 选择数据库

输入主机IP地址，端口，数据库名，用户名和密码。

图2 连接设置

表1 参数说明
参数	描述
主机	目标实例的IP地址。查看目标实例的IP地址的步骤如下：登录云数据库GaussDB的管理控制台。选择目标实例所在区域。单击目标实例名称，进入“基本信息”页面。在“节点列表”模块，查看“弹性公网IP”信息。如果未绑定弹性公网IP，则需要为数据库实例绑定弹性公网IP。具体操作请参考绑定弹性公网IP。
端口	需要连接的数据库端口。创建实例时自定义的端口，GaussDB实例的默认端口为8000。
数据库	需要连接的数据库名。实例创建成功后，会默认生成名称为postgres的数据库。
用户名	需要访问GaussDB实例的账号名称。默认root。
密码	要访问GaussDB实例的账号所对应的密码。

单击“测试连接”，在“驱动设置”弹出框中，单击“下载”，自动下载驱动文件。若弹框中显示“已连接”，则说明可正常连接，单击“确定”。
您也可以自行获取驱动文件后，单击“编辑驱动”，在“库”页签中，手动添加本地驱动文件到驱动编辑器中。

图3 自动下载驱动文件

图4 手动配置本地驱动文件
单击“完成”，即可连接到数据库。在“数据库导航”栏可查看到连接的数据库信息。

相关操作

获取驱动包和驱动包校验包。

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

表2 驱动包下载列表
版本	下载地址
V2.0-8.x	驱动包驱动包校验包
V2.0-3.x	驱动包驱动包校验包
V2.0-2.x	驱动包驱动包校验包

校验驱动包。
为了防止驱动包在传递过程或存储期间被恶意篡改，需要对驱动包进行校验，校验方法如下：
1. 使用快捷键“Win+R”打开“运行”窗口。在“打开”栏，输入“cmd”，按“Enter”回车，打开命令行页面。
2. 执行以下命令，获取驱动包的Hash值。
  certutil -hashfile {驱动包本地目录}\{驱动包名} sha256
  - {驱动包本地目录}：请根据实际下载目录进行替换。例如：C:\Users
  - {驱动包名}：请根据实际下载的驱动包名进行替换。例如：GaussDB_driver.zip
  示例：certutil -hashfile C:\Users\GaussDB_driver.zip sha256
3. 将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包时，只需要关注实例类型即可。