This is an automated email from the ASF dual-hosted git repository.
yiguolei pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/doris-website.git
The following commit(s) were added to refs/heads/master by this push:
new 99d4af5db04 refactor cg (#1606)
99d4af5db04 is described below
commit 99d4af5db04d67286e6ffedd18dcaa7a6ed532aa
Author: yiguolei <guo...@selectdb.com>
AuthorDate: Wed Dec 25 20:02:50 2024 +0800
refactor cg (#1606)
## Versions
- [ x] dev
- [ x] 3.0
- [x ] 2.1
- [ ] 2.0
## Languages
- [ ] Chinese
- [ ] English
## Docs Checklist
- [ ] Checked by AI
- [ ] Test Cases Built
Co-authored-by: yiguolei <yiguo...@gmail.com>
---
.../workload-management/compute-group.md | 16 ++-
.../workload-management/compute-group.md | 155 ---------------------
.../workload-management/compute-group.md | 27 +++-
.../images/compute_group_workload_management.png | Bin 0 -> 49683 bytes
4 files changed, 38 insertions(+), 160 deletions(-)
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/admin-manual/workload-management/compute-group.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/admin-manual/workload-management/compute-group.md
index 6361af03940..f837e3d2f56 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/admin-manual/workload-management/compute-group.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/admin-manual/workload-management/compute-group.md
@@ -24,7 +24,19 @@ specific language governing permissions and limitations
under the License.
-->
-在存算分离架构下，可以将一个或多个计算节点 (BE) 组成一个计算组 (Compute Group)。本文档介绍如何使用计算组，其中涉及的操作包括：
+
+在存算分离架构下，可以将一个或多个计算节点 (BE) 组成一个计算组 (Compute Group)。
+
+
+
+在保持了Resource Group 强隔离的优点的同时，Compute Group与Resource Group 相比还有以下优势：
+
+- 成本更低，由于采用了存算分离的架构，数据位于共享存储中，所以Compute
Group的数量不再受限于副本的数量，用户可以根据需求创建任意多的Compute Group，存储成本不会变多；
+- 更灵活，在存算分离架构下，BE 本地的数据都是缓存，所以增加Compute Group 时不需要做笨重的数据迁移过程，新的Compute Group
只需在查询时缓存预热即可；
+- 隔离更彻底，数据的多副本存储由共享的存储层解决，所以任何Compute Group内的BE 宕机不会像Resource Group 那样导致导入失败。
+
+
+本文档介绍如何使用计算组，其中涉及的操作包括：
- 查看所有计算组
- 计算组授权
@@ -44,7 +56,7 @@ SHOW COMPUTE GROUPS;
## 添加计算组
-使用[ADD BE
](../../sql-manual/sql-statements/Cluster-Management-Statements/ALTER-SYSTEM-ADD-BACKEND.md)命令添加
BE 并为 BE 指定计算组，示例：
+使用[ADD BE
](../../sql-manual/sql-statements/cluster-management/instance-management/ADD-BACKEND.md)命令添加
BE 并为 BE 指定计算组，示例：
```sql
ALTER SYSTEM ADD BACKEND 'host:9050' PROPERTIES ("tag.compute_group_name" =
"new_group");
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/admin-manual/workload-management/compute-group.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/admin-manual/workload-management/compute-group.md
deleted file mode 100644
index 676a618d9fa..00000000000
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/admin-manual/workload-management/compute-group.md
+++ /dev/null
@@ -1,155 +0,0 @@
----
-{
-"title": "Compute Group",
-"language": "zh-CN"
-}
----
-
-<!--
-Licensed to the Apache Software Foundation (ASF) under one
-or more contributor license agreements. See the NOTICE file
-distributed with this work for additional information
-regarding copyright ownership. The ASF licenses this file
-to you under the Apache License, Version 2.0 (the
-"License"); you may not use this file except in compliance
-with the License. You may obtain a copy of the License at
-
- http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing,
-software distributed under the License is distributed on an
-"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-KIND, either express or implied. See the License for the
-specific language governing permissions and limitations
-under the License.
--->
-
-
-在存算分离架构下，可以将一个或多个计算节点 (BE) 组成一个计算组 (Compute Group)。本文档介绍如何使用计算组，其中涉及的操作包括：
-
-- 查看所有计算组
-- 计算组授权
-- 在用户级别绑定计算组 (`default_compute_group`) 以达到用户级别的隔离效果
-
-:::caution 注意
-3.0.2 之前的版本中叫做计算集群（Compute Cluster）。
-:::
-
-## 查看所有计算组
-
-可通过 `SHOW COMPUTE GROUPS` 查看当前仓库拥有的所有计算组。
-
-```sql
-SHOW COMPUTE GROUPS;
-```
-
-## 添加计算组
-
-使用[ADD BE
](../../sql-manual/sql-statements/cluster-management/instance-management/ADD-BACKEND.md)命令添加
BE 并为 BE 指定计算组，示例：
-
-```sql
-ALTER SYSTEM ADD BACKEND 'host:9050' PROPERTIES ("tag.compute_group_name" =
"new_group");
-```
-
-上面命令会将`host:9050`这台节点添加到`new_group`这个计算组中，您也可以不指定计算组，默认会添加到`default_compute_group`组里，示例：
-
-```sql
-ALTER SYSTEM ADD BACKEND 'host:9050';
-```
-
-## 授予计算组访问权限
-
-```sql
-GRANT USAGE_PRIV ON COMPUTE GROUP {compute_group_name} TO {user};
-```
-
-## 撤销计算组访问权限
-
-```sql
-REVOKE USAGE_PRIV ON COMPUTE GROUP {compute_group_name} FROM {user};
-```
-
-## 设置默认计算组
-
-为当前用户设置默认计算组：
-
-```sql
-SET PROPERTY 'default_compute_group' = '{clusterName}';
-```
-
-为其他用户设置默认计算组（此操作需要 Admin 权限）：
-
-```sql
-SET PROPERTY FOR {user} 'default_compute_group' = '{clusterName}';
-```
-
-查看当前用户默认计算组，返回结果中`default_compute_group` 的值即为默认计算组：
-
-```sql
-SHOW PROPERTY;
-```
-
-查看其他用户默认计算组，此操作需要当前用户具备相关权限，返回结果中`default_compute_group` 的值即为默认计算组：
-
-```sql
-SHOW PROPERTY FOR {user};
-```
-
-查看当前仓库下所有可用的计算组：
-
-```sql
-SHOW COMPUTE GROUPS;
-```
-
-:::info 备注
-
-- 若当前用户拥有 Admin 角色，例如：`CREATE USER jack IDENTIFIED BY '123456' DEFAULT ROLE
"admin"`，则：
-
- - 可以为自身以及其他用户设置默认计算组；
-
- - 可以查看自身以及其他用户的 `PROPERTY`。
-
-- 若当前用户无 Admin 角色，例如：`CREATE USER jack1 IDENTIFIED BY '123456'`，则：
-
- - 可以为自身设置默认计算组；
-
- - 可以查看自身的 `PROPERTY`；
-
- - 无法查看所有计算组，因该操作需要 `GRANT ADMIN` 权限。
-
-- 若当前用户未配置默认计算组，现有系统在执行数据读写操作时将会触发错误。为解决这一问题，用户可通过执行 `use @cluster` 命令来指定当前
Context 所使用的计算组，或者使用 `SET PROPERTY` 语句来设置默认计算组。
-
-- 若当前用户已配置默认计算组，但随后该集群被删除，则在执行数据读写操作时同样会触发错误。用户可通过执行 `use @cluster` 命令来重新指定当前
Context 所使用的计算组，或者利用 `SET PROPERTY` 语句来更新默认集群设置。
-
-:::
-
-## 默认计算组的选择机制
-
-当用户未明确设置默认计算组时，系统将自动为用户选择一个具有 Active BE
且用户具有使用权限的计算组。在特定会话中确定默认计算组后，默认计算组将在该会话期间保持不变，除非用户显式更改了默认设置。
-
-在不同次的会话中，若发生以下情况，系统可能会自动更改用户的默认计算组：
-
-- 用户失去了在上次会话中所选择默认计算组的使用权限
-- 有计算组被添加或移除
-- 上次所选择的默认计算组不再具有 Active BE
-
-其中，情况一和情况二必定会导致系统自动选择的默认计算组更改，情况三可能会导致更改。
-
-## 切换计算组
-
-用户可在存算分离架构中指定使用的数据库和计算组。
-
-**语法**
-
-```sql
-USE { [catalog_name.]database_name[@compute_group_name] | @compute_group_name }
-```
-
-若数据库或计算组名称包含是保留关键字，需用反引号将相应的名称 ``` 包围。
-
-## 计算组扩缩容
-
-通过 `ALTER SYSTEM ADD BACKEND` 以及 `ALTER SYSTEM DECOMMISION BACKEND` 添加或者删除 BE
实现计算组的扩缩容。
-
-
-详细操作参考[存算分离相关操作](../../compute-storage-decoupled/overview.md)
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/admin-manual/workload-management/compute-group.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/admin-manual/workload-management/compute-group.md
index d6563614622..f837e3d2f56 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/admin-manual/workload-management/compute-group.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/admin-manual/workload-management/compute-group.md
@@ -24,14 +24,27 @@ specific language governing permissions and limitations
under the License.
-->
-在存算分离架构下，可以将一个或多个计算节点 (BE) 组成一个计算组 (Compute Group)。本文档介绍如何使用计算组，其中涉及的操作包括：
+
+在存算分离架构下，可以将一个或多个计算节点 (BE) 组成一个计算组 (Compute Group)。
+
+
+
+在保持了Resource Group 强隔离的优点的同时，Compute Group与Resource Group 相比还有以下优势：
+
+- 成本更低，由于采用了存算分离的架构，数据位于共享存储中，所以Compute
Group的数量不再受限于副本的数量，用户可以根据需求创建任意多的Compute Group，存储成本不会变多；
+- 更灵活，在存算分离架构下，BE 本地的数据都是缓存，所以增加Compute Group 时不需要做笨重的数据迁移过程，新的Compute Group
只需在查询时缓存预热即可；
+- 隔离更彻底，数据的多副本存储由共享的存储层解决，所以任何Compute Group内的BE 宕机不会像Resource Group 那样导致导入失败。
+
+
+本文档介绍如何使用计算组，其中涉及的操作包括：
- 查看所有计算组
- 计算组授权
- 在用户级别绑定计算组 (`default_compute_group`) 以达到用户级别的隔离效果
-*注意*
+:::caution 注意
3.0.2 之前的版本中叫做计算集群（Compute Cluster）。
+:::
## 查看所有计算组
@@ -43,7 +56,7 @@ SHOW COMPUTE GROUPS;
## 添加计算组
-使用[ADD BE
](../sql-manual/sql-statements/Cluster-Management-Statements/ALTER-SYSTEM-ADD-BACKEND.md)命令添加
BE 并为 BE 指定计算组，示例：
+使用[ADD BE
](../../sql-manual/sql-statements/cluster-management/instance-management/ADD-BACKEND.md)命令添加
BE 并为 BE 指定计算组，示例：
```sql
ALTER SYSTEM ADD BACKEND 'host:9050' PROPERTIES ("tag.compute_group_name" =
"new_group");
@@ -102,13 +115,21 @@ SHOW COMPUTE GROUPS;
:::info 备注
- 若当前用户拥有 Admin 角色，例如：`CREATE USER jack IDENTIFIED BY '123456' DEFAULT ROLE
"admin"`，则：
+
- 可以为自身以及其他用户设置默认计算组；
+
- 可以查看自身以及其他用户的 `PROPERTY`。
+
- 若当前用户无 Admin 角色，例如：`CREATE USER jack1 IDENTIFIED BY '123456'`，则：
+
- 可以为自身设置默认计算组；
+
- 可以查看自身的 `PROPERTY`；
+
- 无法查看所有计算组，因该操作需要 `GRANT ADMIN` 权限。
+
- 若当前用户未配置默认计算组，现有系统在执行数据读写操作时将会触发错误。为解决这一问题，用户可通过执行 `use @cluster` 命令来指定当前
Context 所使用的计算组，或者使用 `SET PROPERTY` 语句来设置默认计算组。
+
- 若当前用户已配置默认计算组，但随后该集群被删除，则在执行数据读写操作时同样会触发错误。用户可通过执行 `use @cluster` 命令来重新指定当前
Context 所使用的计算组，或者利用 `SET PROPERTY` 语句来更新默认集群设置。
:::
diff --git a/static/images/compute_group_workload_management.png
b/static/images/compute_group_workload_management.png
new file mode 100644
index 00000000000..6c22a86d077
Binary files /dev/null and
b/static/images/compute_group_workload_management.png differ
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscr...@doris.apache.org
For additional commands, e-mail: commits-h...@doris.apache.org
