# 管理Doris租户 集群管理员通过FusionInsight Manager页面可以创建Doris租户。 #### 创建Doris租户 1. 登录FusionInsight Manager，单击"租户资源"。 2. 在"租户资源管理"页面单击![](https://support.huaweicloud.com/cmpntguide-lts-mrs/zh-cn_image_0000002096705237.png)，打开添加租户的配置页面，参见[表1]为租户配置属性。 表1租户参数介绍 | 参数名称 | 描述 | |:---|:---| | 名称 | 指定当前租户的名称，长度为3\~50个字符，可包含数字、字母或下划线（_），但不支持创建仅包含数字的Doris租户名称。 根据业务需求规划租户的名称，不得与当前集群中已有的角色、HDFS目录或者Yarn队列重名。 | | 租户类型 | 选择"叶子租户"。 说明： 创建Doris租户，租户类型只能选择"叶子租户"。 | | 计算资源 | 只创建Doris相关租户时，不选择"Yarn"。 | | 存储资源 | 只创建Doris相关租户时，不选择"HDFS"。 | | 服务 | 单击"关联服务"，在关联服务配置以下参数并单击"确定"： - "服务"：选择"Doris"。 - "关联类型"：默认"共享"。 以下参数详细说明可参见[表1](https://support.huaweicloud.com/cmpntguide-lts-mrs/mrs_01_2493088.html#mrs_01_2493088__table19469526134013)。 - "CPU配额权重"：租户占用CPU资源的相对权重，即相对占比，竞争时生效。 - "内存限额占比"：租户最大占用内存资源的百分比，如该值设置为"10"，则当前租户在不同BE节点内存可用为：BE可用内存 \* 10%。因为Doris存在默认租户**normal**，占用了90%，所以其他租户可设置上限为10%，若总和超过100%，Doris租户将创建失败。 - "并发数"：租户最大可运行查询任务的并发数，超过并发数的查询会进入等待队列。 - "队列长度"：租户最大等待执行的查询任务数。 - "队列等待时长（毫秒）"：租户等待执行的查询任务的最大等待时长，单位为毫秒。 - "开启内存软隔离"：默认关闭内存软隔离。如果开启内存软隔离，在资源充足时，可超额占用限额以外内存，在资源紧张时，才会释放多占用的内存。如果关闭内存软隔离，则该Workload Group为内存硬隔离，超过内存可用限额时，部分SQL将被取消或者拒绝执行。 - "调度策略"：MRS 3.6.0-LTS及之后版本，用于设置Doris任务的调度方式，默认调度策略为"公平调度器"。 - "CPU限额占比"：MRS 3.6.0-LTS及之后版本，用于设置租户最大占用CPU的百分比。 | | 描述 | 配置当前租户的描述信息。 | 3. 单击"确定"，等待界面提示租户创建成功。 4. Doris租户创建完成后，可以在"租户资源管理"列表中查看并修改租户资源。 1. 在FusionInsight Manager页面，选择"租户资源"，在租户列表中选中需要查看的Doris租户，查看租户概述和资源配额。 2. 选择"资源"，单击"资源详情"后的![](https://support.huaweicloud.com/cmpntguide-lts-mrs/zh-cn_image_0000002060746462.png)，对租户资源进行修改。 3. 修改完成后，单击"确定"，返回"资源"页面，展示修改后的资源详情。 ![](https://support.huaweicloud.com/cmpntguide-lts-mrs/public_sys-resources/note_3.0-zh-cn.png) - 在"概述"的"资源配额"是静态的，并不是实时刷新，只在加载时更新。 - 因为Doris租户代表的是Workload Group，是对组内任务在单个实例节点的计算资源限制，所以"资源配额"和"图表"都是对指标均值的监控，"图表"每30秒刷新一次。 #### 为已有的租户关联Doris服务和用户 1. 在FusionInsight Manager页面，选择"租户资源"，在租户列表中选择需要操作的租户，选择"服务关联"页签，单击"关联服务"。 2. 在弹出的页签中的"服务"选择"Doris"并按照业务需求配置其他参数，单击"确定"，关联Doris服务。 3. 选择"用户 \> 用户"，单击"关联用户"，为当前租户关联用户，单击"确定"。 ![](https://support.huaweicloud.com/cmpntguide-lts-mrs/public_sys-resources/note_3.0-zh-cn.png) - 也可参考[添加用户并绑定租户]，在用户列表界面新建用户或为已有用户绑定租户。 - 一个租户可以关联多个用户。 - Doris租户支持关联在Manager界面创建的人机用户和机机用户。 - 如果集群已启用Kerberos认证（安全模式），推荐关联人机用户。 - 如果集群未启用Kerberos认证（普通模式），推荐关联机机用户。 - MRS 3.5.0及之前版本，如果关联的是Doris普通用户（即用户绑定的角色不具备"Doris管理员权限"），关联成功后，使用对应的用户在MySQL客户端连接Doris后创建表，并查询表数据会报以下错误： ``` ERROR 1227 (42000): errCode = 2, detailMessage = Access denied; you need (at least one of) the USAGE/ADMIN privilege(s) to use workload group '租户名称'. ``` 需要使用具有Doris管理员权限的用户在MySQL客户端连接Doris后，执行以下命令为当前用户赋权： **GRANT USAGE_PRIV ON workload group** **'** *租户名称* **'** **to** **'** *用户名称* **';** 4. 如果需要解除关联Doris服务，在"服务关联"的Doris服务"操作"列单击"删除"，在弹窗中单击"确定"，解除关联Doris服务。 ![](https://support.huaweicloud.com/cmpntguide-lts-mrs/zh-cn_image_0000002096666717.png "点击放大") ![](https://support.huaweicloud.com/cmpntguide-lts-mrs/public_sys-resources/note_3.0-zh-cn.png) 当租户解除关联Doris服务后，对应Doris内核的Workload Group将被删除，同时绑定该租户的用户的Workload Group也将设置为**normal**。 #### 添加用户并绑定租户 - 新建用户并绑定租户：登录FusionInsight Manager，选择"系统 \> 权限 \> 用户"，单击"添加用户"，添加一个人机用户（集群未启用Kerberos认证（普通模式）需添加机机用户），在角色中添加已创建的Doris租户。 - 为已有的用户绑定租户：登录FusionInsight Manager，选择"系统 \> 权限 \> 用户"，在该用户的"操作"列单击"修改"，在角色中添加已创建的Doris租户。 ![](https://support.huaweicloud.com/cmpntguide-lts-mrs/public_sys-resources/note_3.0-zh-cn.png) - 如果用户需要删除Doris租户，只需在"系统 \> 用户"的用户列表中单击该用户所在行的"修改"，删除角色中绑定的Doris租户即可。 - 不支持一个用户绑定多个Doris租户。即如果**user1** 已关联Doris租户**tenant1** ，需要先从**tenant1** 租户中解绑**user1** ，再将**user1** 关联到**tenant2**。 - 如果集群已启用Kerberos认证（安全模式），推荐人机用户绑定Doris租户；集群未启用Kerberos认证（普通模式），推荐机机用户绑定Doris租户。 - MRS 3.5.0及之前版本，如果关联的是Doris普通用户（即用户绑定的角色不具备"Doris管理员权限"），关联成功后，使用对应的用户在MySQL客户端连接Doris后创建表，并查询表数据会报以下错误： ``` ERROR 1227 (42000): errCode = 2, detailMessage = Access denied; you need (at least one of) the USAGE/ADMIN privilege(s) to use workload group '租户名称'. ``` 需要使用具有Doris管理员权限的用户在MySQL客户端连接Doris后，执行以下命令为当前用户赋权： **GRANT USAGE_PRIV ON workload group** **'** *租户名称* **'** **to** **'** *用户名称* **';**