@@ -5,7 +5,7 @@ import FunctionDescription from '@site/src/components/FunctionDescription';
5
5
6
6
<FunctionDescription description =" 引入或更新于:v1.2.743 " />
7
7
8
- 创建一个具有指定配额设置的工作负载组 (Workload Group)。工作负载组(Workload Group)通过与用户绑定来控制资源分配和查询(Query)并发。当用户提交查询(Query)时,系统会根据用户所属的工作负载组(Workload Group)自动应用相应的资源限制 。
8
+ 创建具有指定配额设置的工作负载组 (Workload Group)。工作负载组通过与用户绑定来控制资源分配和查询并发。当用户提交查询时,系统会根据用户所属的组应用相应限制 。
9
9
10
10
## 语法
11
11
@@ -16,13 +16,13 @@ CREATE WORKLOAD GROUP [IF NOT EXISTS] <group_name>
16
16
17
17
## 参数
18
18
19
- | 参数 | 类型 | 是否必需 | 默认值 | 描述 |
20
- | ------------------------| ------------------ | ----------| -------------| ------------------------------------------------------------------------------|
21
- | ` cpu_quota ` | string | 否 | ( 无限制) | CPU 资源配额,以百分比字符串表示(例如 ` "20%" ` ) |
22
- | ` query_timeout ` | duration | 否 | ( 无限制) | 查询(Query)超时时长( 单位:` s ` /` sec ` =秒,` m ` /` min ` =分钟,` h ` /` hour ` =小时,` d ` /` day ` =天,` ms ` =毫秒,无单位=秒) |
23
- | ` memory_quota ` | string 或 integer | 否 | ( 无限制) | 工作负载组(Workload Group)的最大内存使用限制( 百分比或绝对值) |
24
- | ` max_concurrency ` | integer | 否 | ( 无限制) | 工作负载组(Workload Group)的最大并发数 |
25
- | ` query_queued_timeout ` | duration | 否 | ( 无限制) | 工作负载组(Workload Group)超出最大并发时的最大排队等待时间 (单位:` s ` /` sec ` =秒,` m ` /` min ` =分钟,` h ` /` hour ` =小时,` d ` /` day ` =天,` ms ` =毫秒,无单位=秒) |
19
+ | 参数 | 类型 | 是否必需 | 默认值 | 描述 |
20
+ | ------------------------| -----------------| ----------| -------------| ----------------------------------------------------------------------------------------------------------------- ------------------------------------------------------------------------------|
21
+ | ` cpu_quota ` | string | 否 | ( 无限制) | CPU 资源配额,以百分比字符串表示(例如 ` "20%" ` ) |
22
+ | ` query_timeout ` | duration | 否 | ( 无限制) | 查询超时时长( 单位:` s ` /` sec ` =秒,` m ` /` min ` =分钟,` h ` /` hour ` =小时,` d ` /` day ` =天,` ms ` =毫秒,无单位=秒) |
23
+ | ` memory_quota ` | string 或 integer | 否 | ( 无限制) | 工作负载组的最大内存使用限制( 百分比或绝对值) |
24
+ | ` max_concurrency ` | integer | 否 | ( 无限制) | 工作负载组的最大并发数 |
25
+ | ` query_queued_timeout ` | duration | 否 | ( 无限制) | 当工作负载组超过最大并发数时的最大排队等待时间 (单位:` s ` /` sec ` =秒,` m ` /` min ` =分钟,` h ` /` hour ` =小时,` d ` /` day ` =天,` ms ` =毫秒,无单位=秒) |
26
26
27
27
## 示例
28
28
@@ -39,17 +39,20 @@ WITH cpu_quota = '70%', memory_quota = '80%', max_concurrency = 10;
39
39
40
40
### 用户分配
41
41
42
- 用户必须分配到工作负载组(Workload Group)才能启用资源限制。当用户执行查询(Query)时,系统会自动应用该工作负载组(Workload Group)的限制 。
42
+ 用户必须被分配到工作负载组才能启用资源限制。当用户执行查询时,系统会自动应用工作负载组的限制 。
43
43
44
44
``` sql
45
- -- 创建并分配用户
45
+ -- 创建用户并授予权限
46
46
CREATE USER analytics_user IDENTIFIED BY ' password123' ;
47
+ GRANT ALL ON * .* TO analytics_user;
48
+
49
+ -- 将用户分配到工作负载组
47
50
ALTER USER analytics_user WITH SET WORKLOAD GROUP = ' interactive_queries' ;
48
51
49
- -- 重新分配到不同工作负载组
52
+ -- 重新分配到不同的工作负载组
50
53
ALTER USER analytics_user WITH SET WORKLOAD GROUP = ' batch_processing' ;
51
54
52
- -- 从工作负载组移除(用户将使用默认无限制资源 )
55
+ -- 从工作负载组中移除(用户将使用默认的无限制资源 )
53
56
ALTER USER analytics_user WITH UNSET WORKLOAD GROUP;
54
57
55
58
-- 检查用户的工作负载组
@@ -59,30 +62,30 @@ DESC USER analytics_user;
59
62
## 资源配额归一化
60
63
61
64
### 配额限制
62
- - 每个工作负载组(Workload Group)的 ` cpu_quota ` 和 ` memory_quota ` 最高可设为 ` 100% ` (1.0)
63
- - 所有工作负载组(Workload Group)的配额总和可超过 100%
64
- - 实际资源分配会基于相对比例进行 ** 归一化**
65
+ - 每个工作负载组的 ` cpu_quota ` 和 ` memory_quota ` 最高可设置为 ` 100% ` (1.0)。
66
+ - 所有工作负载组的配额总和可以超过 100%。
67
+ - 实际的资源分配将根据相对比例进行 ** 归一化** 。
65
68
66
- ### 配额归一化原理
69
+ ### 配额归一化工作原理
67
70
68
- 资源按各组配额占总配额的比例分配 :
71
+ 资源根据每个组的配额相对于总配额的比例进行分配 :
69
72
70
73
```
71
- 实际分配 = (组配额) / (所有组配额总和 ) × 100%
74
+ 实际分配比例 = (组配额) / (所有组配额之和 ) × 100%
72
75
```
73
76
74
77
** 示例 1:总配额 = 100%**
75
- - 组 A:30% 配额 → 获得 30% 资源 (30/100)
76
- - 组 B:70% 配额 → 获得 70% 资源 (70/100)
78
+ - 组 A:30% 配额 → 获得 30% 的资源 (30/100)
79
+ - 组 B:70% 配额 → 获得 70% 的资源 (70/100)
77
80
78
81
** 示例 2:总配额 > 100%**
79
- - 组 A:60% 配额 → 获得 40% 资源 (60/150)
80
- - 组 B:90% 配额 → 获得 60% 资源 (90/150)
82
+ - 组 A:60% 配额 → 获得 40% 的资源 (60/150)
83
+ - 组 B:90% 配额 → 获得 60% 的资源 (90/150)
81
84
- 总配额:150%
82
85
83
86
** 示例 3:总配额 < 100%**
84
- - 组 A:20% 配额 → 获得 67% 资源 (20/30)
85
- - 组 B:10% 配额 → 获得 33% 资源 (10/30)
87
+ - 组 A:20% 配额 → 获得 67% 的资源 (20/30)
88
+ - 组 B:10% 配额 → 获得 33% 的资源 (10/30)
86
89
- 总配额:30%
87
90
88
- ** 特殊情况:** 当仅存在一个工作负载组(Workload Group)时,无论其配置配额如何,都将获得 100% 的计算集群(Warehouse)资源。
91
+ ** 特殊情况:** 当只存在一个工作负载组时,无论其配置的配额如何,它都将获得 100% 的计算集群(Warehouse)资源。
0 commit comments