调测SpringBoot样例程序

MRS 3.6.0-LTS.1及之后版本，“hetu-rest-client-example”样例代码，JDK版本只支持JDK 17和JDK 21。

本章节仅适用于MRS 3.6.0-LTS及之后版本。

配置SpringBoot样例程序连接HetuEngine所需的属性信息，在配置文件“springboot\hetu-examples\src\main\resources\application.yml”中配置如下参数。

表1 配置HetuEngine信息
参数	是否必须	说明
host	是	HetuEngine服务的HSFabric地址列表，格式为：HSFabric_IP1:HSFabric_Port,HSFabric_IP2:HSFabric_Port,HSFabric_IP3:HSFabric_Port。登录Manager页面，选择“集群 > 服务 > HetuEngine > 实例”，获取HSFabric所有实例的业务IP；在“配置”页签，搜索“gateway.port”，获取HSFabric的端口号。
catalog	是	HetuEngine计算实例Catalog名称。
schema	是	HetuEngine计算实例Schema名称。
user	是	HetuEngine计算实例连接用户名。
password	是	HetuEngine计算实例连接用户的密码。普通模式集群配置为空。
ssl	是	是否使用SSL连接HetuEngine计算实例。安全模式集群：“true”。普通模式集群：“false”。
tenant	是	任务执行时所使用的队列。

在IDEA界面左下方单击“Terminal”进入终端，执行如下命令进行编译。

mvn clean package
图1 执行编译命令

当输出“BUILD SUCCESS”时表示编译成功。编译成功后将会在样例工程的“target”下生成含有“hetu-rest-client-example”字段的Jar包。

图2 编译成功
在系统中创建一个目录作为运行目录，并将2中生成的含有“hetu-rest-client-example”字段的Jar包放进该路径下。
- 在Windows上创建目录，如“D:\hetu-rest-client-example”。
- 在Linux上创建目录，如“/opt/hetu-rest-client-example”。
执行以下命令启动SpringBoot服务。
- 在Windows环境下执行：
  以管理员身份打开cmd窗口。
  
  执行d:
  
  cd hetu-rest-client-example
  
  java -jar hetu-rest-client-example-*-SNAPSHOT.jar
- Windows下使用JDK编译的包，在Linux使用对应版本的JDK运行：
  - 指定JDK 17运行样例：客户端安装路径/JDK17/jdk/bin/java -classpath hetu-rest-client-example-*.jar。
  - 指定JDK 21运行样例：客户端安装路径/JDK21/jdk/bin/java -classpath hetu-rest-client-example-*.jar。
以上Jar包名称仅供参考，具体名称以实际生成为准。
调用HetuEngine的SpringBoot样例接口触发样例代码运行。
- Windows环境运行方式：
  打开浏览器，输入：http://localhost:8080/hetu/example/executesql。
- Linux环境下运行方式：
  在3中存放Jar包的节点上执行curl http://localhost:8080/hetu/example/executesql。
查看样例代码中的SQL所查询出的结果。

图3 查询结果