使用HetuEngine客户端

操作场景

如果计算实例未创建或未启动，通过登录HetuEngine客户端可主动创建或启动计算实例。该任务指导用户在运维场景或业务场景中使用客户端管理计算实例。

HetuEngine提供服务级默认资源队列配置项，如果没指定租户信息，默认使用Yarn为用户指定的默认租户，可能出现多个用户都默认使用相同的租户队列，从而无法达到资源隔离的效果。

如果用户需要进行资源隔离，将SQL分配给指定的资源队列来执行，来达到资源合理分配的目的时，可通过开启租户的严格校验模式来实现该需求，仅需配置“tenant.strict.mode.enabled”参数为“true”并在使用客户端时添加“--tenant”参数指定租户资源队列即可。

• 开启租户的严格校验模式：适用于MRS 3.3.0及以后版本

  登录Manager，选择“集群 > 服务 > HetuEngine > 配置 > 全部配置”，搜索“tenant.strict.mode.enabled”，将参数的值选为“true”并保存。单击“实例”，勾选配置过期的角色实例，选择“更多 > 重启实例”，根据界面提示重启实例以使配置生效。

• 如果开启了租户的严格校验模式，使用HetuEngine的跨域功能，需要配置HetuEngine数据源的“hsfabric.local.tenant”参数，可参考配置HetuEngine数据源。

前提条件

• 已安装集群客户端。例如安装目录为“/opt/client”。
• 已创建具有Hive（关闭Ranger场景）、hetuuser和default队列权限的HetuEngine普通用户，例如hetu_test。

  创建用户的具体操作请参考创建HetuEngine用户。

操作步骤

1. 以客户端安装用户登录HetuEngine服务客户端所在节点，切换到客户端安装目录。

   cd /opt/client

2. 执行以下命令配置环境变量。

   source bigdata_env

3. 根据集群认证模式，完成HetuEngine客户端登录。
   • 安全模式：执行以下命令，完成用户认证并登录HetuEngine客户端。

     kinit hetu_test

     hetu-cli --catalog hive --tenant default --schema default

   • 普通模式：执行以下命令，登录HetuEngine客户端。

     hetu-cli --catalog hive --tenant default --schema default --user hetu_test

     

     hetu_test是一个至少具备“--tenant”指定租户角色的业务用户，且不能是操作系统用户。

   参数说明：

   • --catalog：（可选）指定的数据源名称。
   • --tenant：（可选）指定集群启动的租户资源队列，不指定为租户的默认队列。使用此参数时，业务用户需要具有该租户对应角色的权限。MRS 3.3.0及以后版本是否可选根据如下判断：
     • 可选：未启用租户的严格校验模式。
     • 必选：启用了租户的严格校验模式。
   • --schema：（可选）指定要访问数据源下的schema名称。
   • --user：（普通模式下必选）指定要登录客户端执行业务的用户名称，该用户至少需要具有“--tenant”指定队列的相应角色。
   

   • 首次登录客户端需要启动后台HetuEngine集群，大约需等待120秒，可以进入客户端界面。
   • 支持SQL语法，兼容开源openLooKeng 1.2.0版本SQL语法。
   • 其他参数可以执行hetu-cli --help查看。