使用PowerBI访问HetuEngine

本章节以PowerBI 1.2.0版本为例，讲解如何访问安全模式集群的HetuEngine。

前提条件

已安装PowerBI。
已获取JDBC jar包文件，获取方法请参考1。
已在集群中创建“人机”用户，如hetu_user，可参考创建HetuEngine用户。启用Ranger鉴权的集群需根据业务需求为该hetu_user添加Ranger权限，可参考添加HetuEngine的Ranger访问权限策略。
已创建计算实例并运行正常，可参考创建HetuEngine计算实例。

操作步骤

使用默认配置安装“hetu-odbc-win64.msi”驱动程序。

图1 下载驱动程序
配置数据源驱动。
1. 在本地命令提示符中执行以下命令停止自动启动的ODBC服务。
  cd C:\Program Files\openLooKeng\openLooKeng ODBC Driver 64-bit\odbc_gateway\mycat\bin
  
  mycat.bat stop
  
  如下表示ODBC服务停止成功：
```
wrapper  | Stopping the Mycat-server service...
wrapper  | Mycat-server stopped.
```
2. 替换JDBC驱动。
  拷贝1中获取的JDBC Jar包到“C:\Program Files\openLooKeng\openLooKeng ODBC Driver 64-bit\odbc_gateway\mycat\lib”目录下，并删除该目录下原始的“hetu-jdbc-1.0.1.jar”包。
3. 编辑ODBC的“server.xml”文件的协议前缀。
  将“C:\Program Files\openLooKeng\openLooKeng ODBC Driver 64-bit\odbc_gateway\mycat\conf”目录中的“server.xml”文件的属性值“<property name="jdbcUrlPrefix">jdbc:lk://</property>”修改为
  
  “<property name="jdbcUrlPrefix">jdbc:trino://</property>”。
4. 配置用户名/密码方式连接。
  在自定义路径，如“C:\hetu”中新建“jdbc_param.properties”文件，添加如下内容：
```
user=admintest
password=密码
```
  user：已创建的“人机”用户的用户名，如：admintest。
  
  password：已创建的“人机”用户的用户密码。配置文件中包含认证密码信息可能存在安全风险，建议当前场景执行完毕后删除相关配置文件或加强安全管理。
5. 执行以下命令重启ODBC服务。
  cd C:\Program Files\openLooKeng\openLooKeng ODBC Driver 64-bit\odbc_gateway\mycat\bin
  
  mycat.bat restart
  
  如下表示ODBC服务重启成功：
```
wrapper  | The Mycat-server service was not running.
wrapper  | Starting the Mycat-server service...
wrapper  | Mycat-server started.
```
  每次修改配置时都需要停止odbc服务，修改完毕后再重启服务。
在window系统的控制面板中输入“odbc”搜索ODBC的管理程序。

图2 查找ODBC程序
在应用程序中选择“添加 > openLookeng ODBC 1.2.0 Driver > 完成”。

图3 添加驱动程序
参考下图填写名称和描述，单击“Next”。

图4 填写名称
参考下图完成参数配置。
1. “Connect URL”为访问HetuEngine服务ODBC连接的URL格式，支持HSFabric方式和HSBroker方式。
  - HSFabric方式：
    <HSFabricIP1:port1>,<HSFabricIP2:port2>,<HSFabricIP3:port3>/catalog名/schema名?serviceDiscoveryMode=hsfabric&tenant=租户名
    
    示例：
    
    192.168.8.37:29902,192.168.8.38:29902,192.168.8.39:29902/hive/default?serviceDiscoveryMode=hsfabric&tenant=default
  - HSBroker方式：
    <HSBrokerIP1:port1>,<HSBrokerIP2:port2>,<HSBrokerIP3:port3>/catalog名/schema名?serviceDiscoveryMode=hsbroker&tenant=default
    
    示例：
    
    192.168.8.37:29860,192.168.8.38:29860,192.168.8.39:29860/hive/default?serviceDiscoveryMode=hsbroker&tenant=租户名
  - 获取HSFabric、HSBroker节点IP及端口号：
    
    登录FusionInsight Manager。
    
    选择“集群 > 服务 > HetuEngine > 实例”，获取HSFabric或HSBroker所有实例的业务IP，可选择一个或多个正常状态的进行连接。
    
    获取端口号，选择“集群 > 服务 > HetuEngine > 配置 > 全部配置”：
    搜索“gateway.port”，获取HSFabric的端口号，安全模式默认为29902，普通模式默认29903；
    
    搜索“server.port”，获取HSBroker的端口号，安全模式默认为29860，普通模式默认29861；
  - 若连接不成功，请关闭代理重试。
  - tenant参数可选，如不设置，随机匹配一个租户。
2. “Connect Config”选择2.d准备好的“jdbc_param.properties”文件。
3. “User name”是下载凭据的用户名称。
图5 配置User name
单击“Test DSN ”测试连接，显示连接成功且“Catalog”和“Schema”中均有内容表示连接成功，单击“Next”。

图6 测试连接

图7 查看内容
单击“Finish”完成连接。

图8 完成连接
使用PowerBI对接，选择“获取数据 > 更多 > ODBC > 连接”。

图9 选择ODBC
选择添加的数据源，单击“确定”完成数据源添加。

图10 添加数据源
输入下载凭据用户的“用户名”及“密码”，单击“连接”。

图11 输入数据库用户名及密码
连接成功后，显示所有表信息，如图12所示。

图12 连接成功