创建ClickHouse租户

操作场景

集群管理员通过FusionInsight Manager页面可以创建ClickHouse租户，并关联逻辑集群。系统用户绑定该租户后，则拥有该租户的逻辑集群相关权限。

创建ClickHouse租户

1. 登录FusionInsight Manager，单击“租户资源”。
2. 单击，打开添加租户的配置页面，参见表1为租户配置属性。

   表1 租户参数一览

   参数名	描述
   集群	选择要创建租户的集群。
   名称	指定当前租户的名称，长度为3~50个字符，可包含数字、字母或下划线（_）。 根据业务需求规划租户的名称，不得与当前集群中已有的角色、HDFS目录或者Yarn队列重名。
   租户资源类型	选择“叶子租户资源” 说明： 创建ClickHouse租户，租户资源类型只能选择“叶子租户”。
   计算资源	为当前租户选择动态计算资源。 选择“Yarn”时，系统自动在Yarn中以租户名称创建任务队列。 不选择“Yarn”时，系统不会自动创建任务队列。
   配置模式	计算资源参数配置模式。 选择“基础”时，只需配置“默认资源池容量 （%）”参数即可。 选择“高级”时，可手动配置资源分配权重，租户的最小/最大/预留资源。
   默认资源池容量 （%）	配置当前租户在默认资源池中使用的计算资源百分比，取值范围0~100%。
   权重	资源分配权重，取值范围从0到100。
   最小资源	保证租户资源能获得的资源（有抢占支持）。取值可以是父租户资源的百分比或绝对值。当租户资源作业量比较少时，资源会自动借给其他租户资源，当租户资源能使用的资源不满足最小资源时，可以通过抢占来要回之前借出的资源。
   最大资源	租户资源最多能使用的资源，租户资源不能得到比最大资源设定更多的资源。取值可以是父租户资源的百分比或绝对值。
   预留资源	租户资源预留资源。即使租户资源内没有作业，预留的资源也不能给别的租户资源使用。取值可以是父租户资源的百分比或绝对值。
   存储资源	为当前租户选择存储资源。 选择“HDFS”时，系统将分配存储资源。 不选择“HDFS”时，系统不会分配存储资源。
   文件\目录数上限	配置文件和目录数量配额。
   存储空间配额	配置当前租户使用的HDFS存储空间配额。 取值范围：当存储空间配额单位设置为MB时，范围为1～8796093022208。当存储空间配额单位设置为GB时，范围为1～8589934592。 此参数值表示租户可使用的HDFS存储空间上限，不代表一定使用了这么多空间。 如果参数值大于HDFS物理磁盘大小，实际最多使用全部的HDFS物理磁盘空间。
   存储路径	配置租户在HDFS中的存储目录。 系统默认将自动在“/tenant”目录中以租户名称创建文件夹。例如租户“ta1”，默认HDFS存储目录为“/tenant/ta1”。 第一次创建租户时，系统自动在HDFS根目录创建“/tenant”目录。支持自定义存储路径。
   服务	“服务”选择“ClickHouse”。 关联类型”：当“服务”选择“ClickHouse”时，关联类型”只支持“共享”。 “关联逻辑集群”：如果ClickHouse没有开启逻辑集群，则默认关联default_cluster，如果已经开启逻辑集群，则按需选择需要关联的逻辑集群。 “CPU优先级”：CPU优先级取值范围为-20~19，该值关联OS的NICE值，取值越小，CPU优先级越高。如需开启CPU优先级请参考开启ClickHouse租户CPU优先级配置。 “内存”：内存限制为百分比，如该值设置为80，则当前租户可使用的内存总额为：服务可使用内存 * 80%。
   描述	配置当前租户的描述信息。

3. 单击“确定”，等待界面提示租户创建成功。
4. ClickHouse租户创建完成后，可以在“租户资源”中查看并修改租户资源。
   1. 在FusionInsight Manager页面，选择“租户资源”，在租户列表中选中需要查看的ClickHouse租户，查看租户概述和资源配额。
   2. 选择“资源”，单击“资源详情”后的，对租户资源进行修改。
   3. 修改完成后，单击“确定”，返回“资源”页面，展示修改后的资源详情。
      

      修改ClickHouse租户资源配额后，需要重新登录ClickHouse客户端才能生效。

添加用户并绑定租户

• 新添加用户绑定租户：登录FusionInsight Manager，选择“系统 > 权限 > 用户”，单击“添加用户”，添加一个人机用户，在角色中添加创建ClickHouse租户的租户。此时该用户具有ClickHouse逻辑集群权限。

• 为已有的用户绑定租户：登录FusionInsight Manager，选择“系统 > 权限 > 用户”，在该用户的“操作”列单击“修改”，在角色中添加创建ClickHouse租户的租户。如果用户需要删除ClickHouse租户，只需在角色中删除ClickHouse租户即可。
  

  • 用户绑定ClickHouse租户后，即用户改租户的逻辑集群权限。
  • 当有多个用户绑定同一个租户时，当前版本租户级别内存限制不支持实时的总量限制。例如user1和user2同时绑定tenant1租户，租户内存限制为10 GB，user1执行的查询共使用内存5 GB，则此时user2发起查询时，会限制user2可使用的内存为5 GB，且在本次查询过程中，服务不会动态的更新这个限制。
  • 当前版本不支持一个用户绑定多个ClickHouse租户，如果user1已经关联tenant1，那么再关联tenant2时，界面不会报错，后台日志中会打印相关说明，该用户已经关联租户，此次关联操作无效。

为已有的租户关联ClickHouse服务

1. 在FusionInsight Manager页面，选择“租户资源”，选中需要操作的租户，选择“服务关联”页签，单击“关联服务”，具体参数如下表所示：

   参数	描述
   服务	选择“ClickHouse”
   关联类型	选择“共享”
   关联逻辑集群	如果ClickHouse没有开启逻辑集群，则默认关联default_cluster，如果已经开启逻辑集群，则按需选择需要关联的逻辑集群
   CPU优先级	CPU优先级取值范围为-20~19，该值关联OS的NICE值，取值越小，CPU优先级越高。如需开启CPU优先级请参考开启ClickHouse租户CPU优先级配置
   内存	内存限制为百分比，如该值设置为80，则当前租户可使用的内存总额为：服务可使用内存 * 80%

2. 在弹出的页签中按照业务需求进行租户配置，单击“确定”，租户关联服务。
3. 如果需要解除关联ClickHouse服务：
   在FusionInsight Manager页面，选择“租户资源”，选中需要操作的租户，在“操作”列单击“删除”，在弹窗中单击“确定”，解除关联ClickHouse服务。

   

   当租户解除关联ClickHouse服务后，该租户将不再拥有ClickHouse逻辑集群的权限。同时绑定该租户的用户也不再拥有ClickHouse逻辑集群的权限。