This is an automated email from the ASF dual-hosted git repository.
kassiez 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 ac051ec08bd Add rename cluster (#1777)
ac051ec08bd is described below
commit ac051ec08bd6e5dac31c0884110fb31943839d99
Author: deardeng <565620...@qq.com>
AuthorDate: Tue Mar 25 12:32:36 2025 +0800
Add rename cluster (#1777)
## Versions
- [ ] dev
- [ ] 3.0
- [ ] 2.1
- [ ] 2.0
## Languages
- [ ] Chinese
- [ ] English
## Docs Checklist
- [ ] Checked by AI
- [ ] Test Cases Built
---
.../managing-compute-cluster.md | 7 +++
.../ALTER-SYSTEM-RENAME-COMPUTE-GROUP.md | 64 ++++++++++++++++++++++
.../managing-compute-cluster.md | 8 +++
.../ALTER-SYSTEM-RENAME-COMPUTE-GROUP.md | 62 +++++++++++++++++++++
4 files changed, 141 insertions(+)
diff --git a/docs/compute-storage-decoupled/managing-compute-cluster.md
b/docs/compute-storage-decoupled/managing-compute-cluster.md
index 581b7ab818b..95d893c03c7 100644
--- a/docs/compute-storage-decoupled/managing-compute-cluster.md
+++ b/docs/compute-storage-decoupled/managing-compute-cluster.md
@@ -161,3 +161,10 @@ If the database or compute group name contains reserved
keywords, the correspond
## Scaling Compute Groups
You can scale compute groups by adding or removing BE using `ALTER SYSTEM ADD
BACKEND` and `ALTER SYSTEM DECOMMISION BACKEND`.
+
+## Renaming Compute Group
+
+You can use the `ALTER SYSTEM RENAME COMPUTE GROUP <old_name> <new_name>`
command to rename an existing compute group. Please refer to the SQL Manual on
[Renaming Compute
Groups](../sql-manual/sql-statements/Cluster-Management-Statements/ALTER-SYSTEM-RENAME-COMPUTE-GROUP.md).
+
+Note
+After renaming a compute group, users who had permissions for the old name
(old_name) or had set the old name as the default compute group
(default_compute_group) will not have their permissions automatically updated
to the new name (new_name). Permissions need to be reset by an account with
administrative privileges. This is consistent with the permission system of
MySQL databases.
\ No newline at end of file
diff --git
a/docs/sql-manual/sql-statements/cluster-management/instance-management/ALTER-SYSTEM-RENAME-COMPUTE-GROUP.md
b/docs/sql-manual/sql-statements/cluster-management/instance-management/ALTER-SYSTEM-RENAME-COMPUTE-GROUP.md
new file mode 100644
index 00000000000..7d17da155b0
--- /dev/null
+++
b/docs/sql-manual/sql-statements/cluster-management/instance-management/ALTER-SYSTEM-RENAME-COMPUTE-GROUP.md
@@ -0,0 +1,64 @@
+---
+{
+ "title": "ALTER-SYSTEM-RENAME-COMPUTE-GROUP",
+ "language": "en"
+}
+
+---
+
+<!--
+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.
+-->
+
+## ALTER-SYSTEM-RENAME-COMPUTE-GROUP
+
+
+### Name
+
+ALTER SYSTEM RENAME COMPUTE-GROUP
+
+### Description
+
+Used for renaming compute groups (admin use only!)
+
+grammar:
+
+- In a separation of storage and computing cluster, this statement is used to
rename an existing compute group. This operation is synchronous, and the
command returns once the execution is complete.
+
+```sql
+ALTER SYSTEM RENAME COMPUTE GROUP <old_name> <new_name>
+```
+
+
+Notes:
+1. The naming rules for compute groups are consistent with the naming rules
for database and table names in DORIS.
+2. All compute groups in the current separation of storage and computing
cluster can be viewed using [SHOW COMPUTE
GROUPS](../Show-Statements/SHOW-COMPUTE-GROUPS.md)。
+3. After the renaming operation is completed, it can also be confirmed by
using [SHOW COMPUTE GROUPS](../Show-Statements/SHOW-COMPUTE-GROUPS.md)。
+4. If the renaming operation fails, you can check the returned message for
reasons, such as the original compute group not existing or the original and
target compute group names being the same.
+
+### Example
+
+1. Rename the compute group named old_name to new_name.
+
+```sql
+ALTER SYSTEM RENAME COMPUTE GROUP <old_name> <new_name>
+```
+
+### Keywords
+
+ALTER, SYSTEM, RENAME, ALTER SYSTEM
\ No newline at end of file
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/compute-storage-decoupled/managing-compute-cluster.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/compute-storage-decoupled/managing-compute-cluster.md
index abaa7b5a22d..5a8af020408 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/compute-storage-decoupled/managing-compute-cluster.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/compute-storage-decoupled/managing-compute-cluster.md
@@ -160,3 +160,11 @@ USE { [catalog_name.]database_name[@compute_group_name] |
@compute_group_name }
## 计算组扩缩容
通过 `ALTER SYSTEM ADD BACKEND` 以及 `ALTER SYSTEM DECOMMISION BACKEND` 添加或者删除 BE
实现计算组的扩缩容。
+
+
+## 重命名计算组
+
+您可以使用 `ALTER SYSTEM RENAME COMPUTE GROUP <old_name> <new_name>`
命令来重命名现有的计算组。请参阅[重命名计算组SQL手册](../sql-manual/sql-statements/Cluster-Management-Statements/ALTER-SYSTEM-RENAME-COMPUTE-GROUP.md)
+
+*注意*
+在重命名计算组后，拥有旧名称（old_name）计算组权限的用户，或将旧名称设置为默认计算组（default_compute_group）的用户，其权限不会自动更新为新名称（new_name）。需要由具有管理员权限的账户重新设置权限。这与
MySQL 数据库的权限体系保持一致。
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-statements/cluster-management/instance-management/ALTER-SYSTEM-RENAME-COMPUTE-GROUP.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-statements/cluster-management/instance-management/ALTER-SYSTEM-RENAME-COMPUTE-GROUP.md
new file mode 100644
index 00000000000..3a2e2d49391
--- /dev/null
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-statements/cluster-management/instance-management/ALTER-SYSTEM-RENAME-COMPUTE-GROUP.md
@@ -0,0 +1,62 @@
+---
+{
+ "title": "ALTER-SYSTEM-RENAME-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.
+-->
+
+## ALTER-SYSTEM-RENAME-COMPUTE-GROUP
+
+### Name
+
+ALTER SYSTEM RENAME COMPUTE-GROUP
+
+### Description
+
+用于重命名计算组（仅限管理员使用！）
+
+语法：
+
+- 在存算分离集群中，该语句用于重命名现有的计算组。此操作是同步的，命令返回即表示执行完毕。
+
+```sql
+ALTER SYSTEM RENAME COMPUTE GROUP <old_name> <new_name>
+```
+
+说明：
+1. 计算组的命名规则与DORIS中库表名的命名规则一致。
+2. 当前存算分离集群中的所有计算组，可以通过[显示计算组](../Show-Statements/SHOW-COMPUTE-GROUPS.md)查看。
+3. 重命名操作完成后，也可以通过[显示计算组](../Show-Statements/SHOW-COMPUTE-GROUPS.md)进行确认。
+4. 如果重命名操作失败，可以根据返回的提示信息查找原因，例如原计算组不存在，或者原计算组名称与目标计算组名称相同等。
+
+### Example
+
+1. 将名为 old_name 的计算组重命名为 new_name
+
+```sql
+ALTER SYSTEM RENAME COMPUTE GROUP <old_name> <new_name>
+```
+
+### Keywords
+
+ALTER, SYSTEM, RENAME, ALTER SYSTEM
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscr...@doris.apache.org
For additional commands, e-mail: commits-h...@doris.apache.org
