# 通过DBeaver连接实例
DBeaver是一个通用的数据库客户端，可以通过配置不同驱动连接各种不同的数据库。本章介绍如何通过DBeaver连接GaussDB实例。
![](https://support.huaweicloud.com/usermanual-gaussdb/public_sys-resources/note_3.0-zh-cn.png)
本章节以DBeaver 24.1.4版本为例提供连接指导。因DBeaver不同版本的操作界面可能不同，如需了解其他版本的操作，请参考对应版本的DBeaver产品文档。
#### 步骤一：获取DBeaver客户端安装包
DBeaver官网提供了针对不同操作系统的客户端安装包，单击[此处](https://dbeaver.io/files/)访问DBeaver官网下载系统对应的DBeaver客户端安装包并完成安装。
#### 步骤二：连接数据库
1. 在DBeaver客户端单击![](https://support.huaweicloud.com/usermanual-gaussdb/figure/zh-cn_image_0000002649933534.png)，打开创建连接界面。
2. 在SQL页签中，选择GaussDB数据库，单击"下一步"。
   图1选择数据库   
   ![](https://support.huaweicloud.com/usermanual-gaussdb/figure/zh-cn_image_0000002649773646.png "点击放大")
   
   
3. 输入主机IP地址，端口，数据库名，用户名和密码。
   图2连接设置   
   ![](https://support.huaweicloud.com/usermanual-gaussdb/figure/zh-cn_image_0000002679853375.png "点击放大")
   
   表1参数说明 
   | 参数  | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
   |:---|:---|
   | 主机  | 目标实例的IP地址。查看目标实例的IP地址的步骤如下： 1. 登录云数据库GaussDB的管理控制台。  2. 选择目标实例所在区域。  3. 单击目标实例名称，进入"基本信息"页面。  4. 在"节点列表"模块，查看"弹性公网IP"信息。 如果未绑定弹性公网IP，则需要为数据库实例绑定弹性公网IP。具体操作请参考[绑定弹性公网IP](https://support.huaweicloud.com/usermanual-gaussdb/gaussdb_01_160.html)。    |
   | 端口  | 需要连接的数据库端口。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
   | 数据库 | 需要连接的数据库名。实例创建成功后，会默认生成名称为postgres的数据库。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
   | 用户名 | 需要访问GaussDB实例的账号名称。默认root。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
   | 密码  | 要访问GaussDB实例的账号所对应的密码。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
      
   
4. 单击"测试连接"，在"驱动设置"弹出框中，单击"下载"，自动下载驱动文件。若弹框中显示"已连接"，则说明可正常连接，单击"确定"。 您也可以自行[获取驱动文件]后，单击"编辑驱动"，在"库"页签中，手动添加本地驱动文件到驱动编辑器中。
   图3自动下载驱动文件   
   ![](https://support.huaweicloud.com/usermanual-gaussdb/figure/zh-cn_image_0000002679853371.png "点击放大")
   
   图4手动配置本地驱动文件   
   ![](https://support.huaweicloud.com/usermanual-gaussdb/figure/zh-cn_image_0000002680013215.png)
   
   
5. 单击"完成"，即可连接到数据库。在"数据库导航"栏可查看到连接的数据库信息。
 
 #### 相关操作
1. 获取驱动包和驱动包校验包。
   表2驱动包下载地址 
   | 驱动包下载地址                                                                                                                                                | 校验包下载地址                                                                                                                                                          |
   |:---|:---|
   | [驱动包](https://dbs-download.obs.cn-north-1.myhuaweicloud.com/DBS-GaussDB-driver/1782715650051/DBS-GaussDB-driver_507.0_20260629130806.133858239.tar.gz) | [驱动包校验包](https://dbs-download.obs.cn-north-1.myhuaweicloud.com/DBS-GaussDB-driver/1782715650051/DBS-GaussDB-driver_507.0_20260629130806.133858239.tar.gz.sha256) |
      
   
   
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包。
   ![](https://support.huaweicloud.com/usermanual-gaussdb/public_sys-resources/note_3.0-zh-cn.png)
   JDBC驱动包不区分操作系统和架构。因此，在获取gsjdbc4.jar包时，只需要关注实例类型即可。