创建ClickHouse租户
本章节内容仅适用于MRS 3.2.0及之后版本。
操作场景
集群管理员通过FusionInsight Manager页面可以创建ClickHouse租户，并关联逻辑集群。系统用户绑定该租户后，则拥有该租户的逻辑集群相关权限。
创建ClickHouse租户
- 登录FusionInsight Manager，单击“租户资源”。
- 单击
，打开添加租户的配置页面，参见表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%。
描述
配置当前租户的描述信息。
- 单击“确定”，等待界面提示租户创建成功。
- ClickHouse租户创建完成后，可以在“租户资源”中查看并修改租户资源。
- 在FusionInsight Manager页面，选择“租户资源”，在租户列表中选中需要查看的ClickHouse租户，查看租户概述和资源配额。
- 选择“资源”，单击“资源详情”后的
，对租户资源进行修改。 - 修改完成后，单击“确定”，返回“资源”页面，展示修改后的资源详情。
修改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服务
- 在FusionInsight Manager页面，选择“租户资源”，选中需要操作的租户，选择“服务关联”页签，单击“关联服务”，具体参数如下表所示：
参数
描述
服务
选择“ClickHouse”
关联类型
选择“共享”
关联逻辑集群
如果ClickHouse没有开启逻辑集群，则默认关联default_cluster，如果已经开启逻辑集群，则按需选择需要关联的逻辑集群
CPU优先级
CPU优先级取值范围为-20~19，该值关联OS的NICE值，取值越小，CPU优先级越高。如需开启CPU优先级请参考开启ClickHouse租户CPU优先级配置
内存
内存限制为百分比，如该值设置为80，则当前租户可使用的内存总额为：服务可使用内存 * 80%
- 在弹出的页签中按照业务需求进行租户配置，单击“确定”，租户关联服务。
- 如果需要解除关联ClickHouse服务：
