通过DBeaver连接实例

步骤一：获取驱动包

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

   根据不同版本的实例，下载对应版本的驱动包和驱动包校验包到本地任意目录，如#ZH-CN_TOPIC_0000001715306770/table1067132914913所示。

2. 校验驱动包。

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

   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进行校验。
3. 解压驱动包，获取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客户端安装包并完成安装 。

步骤三：创建新驱动

1. 打开DBeaver客户端。
2. 单击“数据库 > 驱动管理器”，打开驱动管理器界面。
3. 单击“新建”，打开创建新驱动界面。
4. 在“设置”页签中，正确输入驱动名称、类名、URL模板、默认端口、Default Database、Default User，选择驱动类型，单击“确定”创建驱动。

   表1 参数说明

   参数	描述
   驱动名称	命名为便于识别的名称，例如GaussDB Driver。
   驱动类型	驱动类型选择Generic。
   类名	类名为org.postgresql.Driver。
   URL模板	URL模板为jdbc:postgresql://{host}[:{port}]/[{database}]。
   默认端口	需要连接的数据库端口。创建实例时自定义的端口，GaussDB实例的默认端口为8000。
   Default Database	需要连接的数据库名。实例创建成功后，会默认生成名称为postgres的数据库。
   Default User	需要访问GaussDB实例的账号名称。默认root。

5. 在“库”页签中，单击添加文件，选择步骤一第3步中的gsjdbc4.jar。
6. 添加后驱动类为空，需要单击“找到类”，选择识别出来的驱动类。驱动类需要与“设置”页的“类名”一致。
7. 单击“确定”，驱动设置完成。

步骤四：连接数据库

1. 在DBeaver客户端单击，打开创建连接界面。
2. 搜索步骤三中创建的驱动，选中驱动，单击“下一步”。
   图1 选择驱动
   
3. 输入主机IP地址，端口，数据库名，用户名和密码。

   表2 参数说明

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

4. 单击“测试链接”。若弹框中显示“已连接”，则说明可正常连接，单击“确定”。
5. 单击“完成”，即可连接到数据库。在“数据库导航”栏可查看到连接的数据库信息。