使用DBeaver访问HetuEngine

前提条件

• DBeaver已正常安装。DBeaver软件下载链接：https://dbeaver.io/download/ 。
• 已在集群中创建“人机”用户，如hetu_user，可参考创建HetuEngine用户。启用Ranger鉴权的集群需根据业务需求为该hetu_user添加Ranger权限，可参考添加HetuEngine的Ranger访问权限策略。
• 已创建计算实例并运行正常，可参考创建HetuEngine计算实例。

操作步骤

1. 下载HetuEngine客户端获取JDBC jar包。
   1. 登录FusionInsight Manager。
   2. 选择“集群 > 服务 > HetuEngine > 概览”。
   3. 在页面右上角，选择“更多 > 下载客户端”，根据界面提示下载“完整客户端”文件到本地。
   4. 解压HetuEngine客户端压缩包文件“FusionInsight_Cluster_集群ID_ HetuEngine_Client.tar”获取jdbc文件，并存放在本地，例如“D:\test”。
      

      jdbc文件获取方法：

      在“FusionInsight_Cluster_集群ID_HetuEngine_ClientConfig\HetuEngine\xxx\”路径下解压获取“hetu-jdbc-*.jar”文件。

      备注：xxx为“arm”或“x86”。

2. 在本地hosts文件添加主机映射。

   根据使用HSFabric方式或HSBroker方式添加对应实例所在主机映射，格式为：主机IP 主机名

   例如：192.168.42.90 server-2110081635-0001

   

   Windows本地hosts文件存放路径举例：“C:\Windows\System32\drivers\etc”。

3. 打开DBeaver，选择“数据库 > 新建连接”，在“ALL”中搜索“Trino”并打开Trino。
4. 单击“编辑驱动设置”，参考下表信息设置相关参数。

   表1 驱动设置信息

   参数名	参数值
   类名	io.trino.jdbc.TrinoDriver
   URL模板	通过HSFabric方式访问HetuEngine jdbc:trino://<HSFabricIP1:port1>,<HSFabricIP2:port2>,<HSFabricIP3:port3>/catalog名/schema名?serviceDiscoveryMode=hsfabric&tenant=租户名 示例： jdbc:trino://192.168.42.90:29902,192.168.42.91:29902,192.168.42.92:29902/hive/default?serviceDiscoveryMode=hsfabric&tenant=default 通过HSBroker方式访问HetuEngine jdbc:trino://<HSBrokerIP1:port1>,<HSBrokerIP2:port2>,<HSBrokerIP3:port3>/catalog名/schema名?serviceDiscoveryMode=hsbroker&tenant=租户名 示例： jdbc:trino://192.168.42.90:29860,192.168.42.91:29860,192.168.42.92:29860/hive/default?serviceDiscoveryMode=hsbroker&tenant=default

   

   • 获取HSFabric、HSBroker节点IP及端口号：
     1. 登录FusionInsight Manager。
     2. 选择“集群 > 服务 > HetuEngine > 实例”，获取HSFabric或HSBroker所有实例的业务IP，可选择一个或多个正常状态的进行连接。
     3. 获取端口号，选择“集群 > 服务 > HetuEngine > 配置 > 全部配置”：

        搜索“gateway.port”，获取HSFabric的端口号，安全模式默认为29902，普通模式默认29903；

        搜索“server.port”，获取HSBroker的端口号，安全模式默认为29860，普通模式默认29861；

   • 若连接不成功，请关闭代理重试。
   • tenant参数可选，如不设置，随机匹配一个租户。

5. 单击“添加文件”，上传1中获取的JDBC驱动包。
6. 单击“找到类”，自动获取驱动类，单击“确定”完成驱动设置，如下图所示。若“库”中存在“io.trino:trino-jdbc:RELEASE”，单击“找到类”前需将其删掉。
   图1 安全模式驱动设置（设置）
   
   图2 安全模式驱动设置（库）
   

7. 连接设置。
   • 安全模式（开启Kerberos认证的集群）：

     在创建新连接页面的“常规”页签，输入前提条件中创建的用户名和密码，单击“测试链接”，连接成功后，单击“确定”，再单击“完成”。可单击“连接详情（名称、类型...）”修改连接名称。

     图3 安全模式“常规”参数设置
     
   • 普通模式（未开启Kerberos认证的集群）：

     在创建新连接页面的“常规”页签，配置“JDBC URL”后，不填写用户名的“密码”。

     在创建新连接页面的“驱动属性”配置如下参数，“user”为前提条件中创建的用户。单击“测试链接”，连接成功后，单击“确定”，再单击“完成”。可单击“连接详情（名称、类型...）”修改连接名称。

     图4 普通模式“驱动属性”参数设置
     

8. 连接成功后进入如下图所示页面。
   图5 连接成功