# 创建ClickHouse租户 #### 操作场景 在多租户大数据集群环境中，不同业务团队共享同一ClickHouse集群资源时，需要通过租户机制实现资源的隔离与分配。ClickHouse租户可以将集群的计算资源（CPU、内存）和存储资源（HDFS配额）按业务需求划分给不同租户，避免某个业务的高负载查询影响其他业务的正常运行。 集群管理员通过FusionInsight Manager页面可以创建ClickHouse租户，并关联逻辑集群。系统用户绑定该租户后，则拥有该租户的逻辑集群相关权限。 #### 约束与限制 本章节仅适用于MRS 3.2.0-LTS及之后版本。 #### 创建ClickHouse租户 1. 登录FusionInsight Manager系统。 详细操作请参考[访问集群Manager](https://support.huaweicloud.com/cmpntguide-lts-mrs/mrs_01_2124.html)。 2. 选择"租户资源"，单击![](https://support.huaweicloud.com/cmpntguide-lts-mrs/zh-cn_image_0000001676747790.png "点击放大")，打开添加租户的配置页面，参见[表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优先级配置](https://support.huaweicloud.com/cmpntguide-lts-mrs/mrs_01_24789.html)。 - "内存"：内存限制为百分比，如该值设置为80，则当前租户可使用的内存总额为：服务可使用内存 \* 80%。 | | 描述 | 配置当前租户的描述信息。 | 3. 单击"确定"，等待界面提示租户创建成功。 4. ClickHouse租户创建完成后，可以在"租户资源"中查看并修改租户资源。 1. 在FusionInsight Manager页面，选择"租户资源"，在租户列表中选中需要查看的ClickHouse租户，查看租户概述和资源配额。 2. 选择"资源"，单击"资源详情"后的![](https://support.huaweicloud.com/cmpntguide-lts-mrs/zh-cn_image_0000001724866865.png)，对租户资源进行修改。 3. 修改完成后，单击"确定"，返回"资源"页面，展示修改后的资源详情。 4. 修改ClickHouse租户资源配额后，需要重新登录ClickHouse客户端才能生效。登录ClickHouse客户端请参考[ClickHouse客户端使用实践](https://support.huaweicloud.com/cmpntguide-lts-mrs/mrs_01_2345.html)。 #### 添加用户并绑定租户 - 新添加用户绑定租户：登录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优先级配置](https://support.huaweicloud.com/cmpntguide-lts-mrs/mrs_01_24789.html) | | 内存 | 内存限制为百分比，如该值设置为80，则当前租户可使用的内存总额为：服务可使用内存 \* 80% | 2. 在弹出的页签中按照业务需求进行租户配置，单击"确定"，租户关联服务。 3. 如果需要解除关联ClickHouse服务： 在FusionInsight Manager页面，选择"租户资源"，选中需要操作的租户，在"操作"列单击"删除"，在弹窗中单击"确定"，解除关联ClickHouse服务。 当租户解除关联ClickHouse服务后，该租户将不再拥有ClickHouse逻辑集群的权限。同时绑定该租户的用户也不再拥有ClickHouse逻辑集群的权限。 #### 相关文档 - 了解如何安装和使用ClickHouse客户端连接ClickHouse服务，具体请参考[ClickHouse客户端使用实践](https://support.huaweicloud.com/cmpntguide-lts-mrs/mrs_01_2345.html)。 - 了解如何为ClickHouse租户配置CPU调度优先级，具体请参考[开启ClickHouse租户CPU优先级配置](https://support.huaweicloud.com/cmpntguide-lts-mrs/mrs_01_24789.html)。 - 了解更多ClickHouse用户权限管理（如修改、删除租户等），具体请参考[ClickHouse用户权限管理](https://support.huaweicloud.com/cmpntguide-lts-mrs/mrs_01_24251.html)。