使用HetuEngine客户端

操作场景

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

前提条件

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

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

操作步骤

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

   cd /opt/client

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

   source bigdata_env

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

     kinit hetu_test

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

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

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

     

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

   参数说明：

   • --catalog：（可选）指定的数据源名称。
   • --tenant：（可选）指定集群启动的租户资源队列，不指定为租户的默认队列。使用此参数时，业务用户需要具有该租户对应角色的权限。
   • --schema：（可选）指定要访问数据源下的schema名称。
   • --user：（普通模式下必选）指定要登录客户端执行业务的用户名称，该用户至少需要具有“--tenant”指定队列的相应角色。
   

   • 首次登录客户端需要启动后台HetuEngine集群，大约需等待40秒，可以进入客户端界面。
   • 支持SQL语法，兼容开源openLooKeng 1.2.0版本SQL语法。