8.5 计算组操作¶

在存算分离架构下，可以将一个或多个计算节点（ BE ）组成一个计算组（ Compute Group ）。本文档介绍如何使用计算组，其中涉及的操作包括：

注意 3.0.2 之前的版本中叫做计算集群（ Compute Cluster ）。

1 查看所有计算组¶

可通过 SHOW COMPUTE GROUPS 查看当前仓库拥有的所有计算组。

SQL
SHOW COMPUTE GROUPS;

使用 Add BE 命令添加 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;

Tip

若当前用户拥有 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 且用户具有使用权限的计算组。在特定会话中确定默认计算组后，默认计算组将在该会话期间保持不变，除非用户显式更改了默认设置。

在不同次的会话中，若发生以下情况，系统可能会自动更改用户的默认计算组：

其中，情况一和情况二必定会导致系统自动选择的默认计算组更改，情况三可能会导致更改。

用户可在存算分离架构中指定使用的数据库和计算组。

语法

SQL
USE { [catalog_name.]database_name[@compute_group_name] | @compute_group_name }

若数据库或计算组名称包含是保留关键字，需用反引号将相应的名称 ` 包围。

通过 ALTER SYSTEM ADD BACKEND 以及 ALTER SYSTEM DECOMMISION BACKEND 添加或者删除 BE 实现计算组的扩缩容。