通过DBeaver连接实例

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

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

步骤二：连接数据库

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

3. 输入主机IP地址，端口，数据库名，用户名和密码。
   图2 连接设置
   

   表1 参数说明

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

4. 单击“测试连接”，在“驱动设置”弹出框中，单击“下载”，自动下载驱动文件。若弹框中显示“已连接”，则说明可正常连接，单击“确定”。

   您也可以自行获取驱动文件后，单击“编辑驱动”，在“库”页签中，手动添加本地驱动文件到驱动编辑器中。

   图3 自动下载驱动文件
   
   图4 手动配置本地驱动文件
   

5. 单击“完成”，即可连接到数据库。在“数据库导航”栏可查看到连接的数据库信息。

相关操作

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

   表2 驱动包下载地址

   驱动包下载地址	校验包下载地址
   驱动包	驱动包校验包

2. 校验驱动包。

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

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

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

      • {驱动包本地目录}：请根据实际下载目录进行替换。例如：C:\Users
      • {驱动包名}：请根据实际下载的驱动包名进行替换。例如：DBS-GaussDB-driver_507.0_20260629130806.133858239.tar.gz

      示例：certutil -hashfile C:\Users\DBS-GaussDB-driver_507.0_20260629130806.133858239.tar.gz

   3. 将2.b获取到的Hash值和1中获取到的驱动包校验包的Hash值进行比较。
      • 若一致则通过校验。
      • 若不一致，请重新下载驱动包，重复2.a~2.c进行校验。
3. 解压驱动包，获取gsjdbc4.jar包。

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

   需要连接分布式版实例，首先您需要进入到DBS-GaussDB-driver_*\Distributed路径下，找到jdbc_driver.tar.gz包进行解压。然后进入到jdbc_driver\Euler2.5_X86_64路径下找到GaussDB-Kernel_数据库版本号_Jdbc_X86_Jdk版本号_Distributed.tar.gz，选择与当前环境JDK适配的包进行解压。最后获取GaussDB-Kernel_507.0.0_Euler_64bit_Jdbc.tar.gz包进行解压，获取到gsjdbc4.jar包。

   

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