GaussDB通过DBeaver连接实例

168 阅读4分钟

通过DBeaver连接实例

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

步骤一:获取驱动包**
  1. 获取驱动包和驱动包校验包。

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

    版本下载地址
    V2.0-8.x驱动包驱动包校验包
    V2.0-3.x驱动包驱动包校验包
    V2.0-2.x驱动包驱动包校验包
  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,选择驱动类型,单击“确定”创建驱动。

    参数描述
    驱动名称命名为便于识别的名称,例如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地址,端口,数据库名,用户名和密码。

    参数描述
    主机目标实例的IP地址。查看目标实例的IP地址的步骤如下:1. 登录云数据库GaussDB的管理控制台。
    1. 选择目标实例所在区域。

    2. 单击目标实例名称,进入“基本信息”页面。

    3. 在“节点列表”模块,查看“弹性公网IP”信息。

      如果未绑定弹性公网IP,则需要为数据库实例绑定弹性公网IP。具体操作请参考绑定弹性公网IP。 | | 端口 | 需要连接的数据库端口。创建实例时自定义的端口,GaussDB实例的默认端口为8000。 | | 数据库/模式 | 需要连接的数据库名。实例创建成功后,会默认生成名称为postgres的数据库。 | | 用户名 | 需要访问GaussDB实例的账号名称。默认root。 | | 密码 | 要访问GaussDB实例的账号所对应的密码。 |

  4. 单击“测试链接”。若弹框中显示“已连接”,则说明可正常连接,单击“确定”。

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

父主题: 连接GaussDB实例