Adding a Tenant
Doris's multi-tenant management feature is designed to minimize cross-tenant interference while multiple users conduct data operations within the same Doris cluster. It ensures optimal distribution of cluster resources among users. It encompasses tenant lifecycle management, resource configuration for tenants, and monitoring of tenant resource consumption. It offers a sophisticated multi-tenant management framework that enables enterprises to execute centralized management of tenants and services effectively.
Creating a Tenant
- Log in to the CloudTable console.
- Select a region in the upper left corner.
- Click Cluster Management on the left. The current cluster list is displayed.
- Locate the cluster to be operated and click Cluster Name > Tenant Management. The Tenant Management page is displayed.
- Click Create Tenant in the upper right corner of the page. On the displayed page, configure tenant attributes by referring to Table 1.
Table 1 Parameters for creating a tenant Parameter
Value Range
Description
Tenant Name
-
Name of the current tenant. The value must start with a letter and contain 4 to 64 characters. Only uppercase letters, lowercase letters, digits, and underscores (_) are allowed.
CPU Quota Weight
1~922337203685477580
Weight of CPU resources that can be used by a tenant
Memory Quota Percentage (%)
1%~100%
Maximum proportion of memory that can be used by a tenant
Concurrent Requests
1~2147483647
Maximum number of concurrent query tasks that a tenant can run This parameter specifies the maximum number of tasks on each FE node. For example, if the number of concurrent SQL statements is set to 1 and the Doris has three FE nodes, the maximum number of SQL statements that can be executed in a cluster is 3.
Queue Length
1~2147483647
Maximum number of waiting query tasks Excessive SQL statements are queued. When the queue is full, newly submitted queries are rejected.
Queue Waiting Duration (ms)
1~2147483647
Maximum waiting duration of a tenant query task If the query waiting duration exceeds the value of this parameter, the query is rejected. The unit is millisecond.
Enabling Memory Soft Isolation
Enable/Disable
Whether a tenant can use more memory resources than the limit
- If this function is disabled, the system immediately cancels the tasks that occupy the most memory in the tenant groups when detecting that the memory usage of the tenant exceeds the upper limit.
- If this function is enabled and the cluster has idle memory resources, the tenant can use the system memory more than the limit. The tasks that occupy the most memory in the tenant groups are canceled only when cluster resources are insufficient.
- Click OK. The tenant is created.
Binding a User to a Tenant
- Log in to the CloudTable console.
- Select a region in the upper left corner.
- Click Cluster Management on the left. The current cluster list is displayed.
- Locate the cluster to be operated and click Cluster Name > User Management. The User Management page is displayed.
- Select the user to be bound and choose More > Assign Tenant in the Operation column. The Assign Tenant dialog box is displayed.
- After selecting a tenant, click OK. The tenant is bound to the user.Note
- By default, a new user is bound to the default tenant normal.
- A user can be bound to only one tenant.
- A tenant can be bound to multiple users.
Managing Tenants
- Log in to the CloudTable console.
- Select a region in the upper left corner.
- Click Cluster Management on the left. The current cluster list is displayed.
- Locate the cluster to be operated and click Cluster Name > Tenant Management. The Tenant Management page is displayed.
- Select the tenant to be edited and click Modify in the Operation column. In the displayed dialog box, modify parameters and click OK.Note
The tenant name cannot be changed.
- If the tenant is unavailable, you can also delete the tenant by clicking Delete in the Operation column. In the displayed confirmation dialog box, click OK.
- To view the monitoring information of a tenant under multi-tenancy, click View Monitoring Information in the Operation column of the target tenant.
- Creating a Tenant
- Binding a User to a Tenant
- Managing Tenants