计算组操作
在存算分离架构下，可以将一个或多个计算节点 (BE) 组成一个计算组 (Compute Group)。本文档介绍如何使用计算组，其中涉及的操作包括：
- 查看所有计算组
- 计算组授权
- 在用户级别绑定计算组 (
default_compute_group) 以达到用户级别的隔离效果
注意 3.0.2 之前的版本中叫做计算集群（Compute Cluster）。
计算组使用场景
在多计算组的架构下，可以通过将一个或多个无状态的 BE 节点组成计算集群，利用计算集群指定语句 (use @<compute_group_name>) 将特定负载分配到特定的计算集群中，从而实现多导入和查询负载的物理隔离。
假设当前有两个计算集群：C1 和 C2。
-
读读隔离：在发起两个大型查询之前，分别使用
use @c1和use @c2，确保两个查询在不同的计算节点上运行，从而避免在访问相同数据集时因 CPU 和内存等资源竞争而相互干扰。 -
读写隔离：Doris 的数据导入会消耗大量资源，尤其是在大数据量和高频导入的场景中。为了避免查询和导入之间的资源竞争，可以通过
use @c1和use @c2指定查询在 C1 上执行，导入在 C2 上执行。同时，C1 计算集群可以访问 C2 计算集群中新导入的数据。 -
写写隔离：与读写隔离类似，导入之间也可以进行隔离。例如，当系统中存在高频小量导入和大批量导入时，批量导入通常耗时较长且重试成本高，而高频小量导入耗时短且重试成本低。为了避免小量导入对批量导入的干扰，可以通过
use @c1和use @c2，将小量导入指定到 C1 上执行，批量导入指定到 C2 上执行。
默认计算组的选择机制
当用户未明确设置默认计算组时，系统将自动为用户选择一个具有存活计算节点且用户具有使用权限的计算组。在特定会话中确定默认计算组后，默认计算组将在该会话期间保持不变，除非用户显式更改了默认设置。
在不同次的会话中，若发生以下情况，系统可能会自动更改用户的默认计算组：
- 用户失去了在上次会话中所选择默认计算组的使用权限
- 有计算组被添加或移除
- 上次所选择的默认计算组不再具有存活计算节点
其中，情况一和情况二必定会导致系统自动选择的默认计算组更改，情况三可能会导致更改。
查看所有计算组
使用 SHOW COMPUTE GROUPS 命令可以查看当前仓库中的所有计算组。返回结果会根据用户权限级别显示不同内容：
- 具有
ADMIN权限的用户可以查看所有计算组 - 普通用户只能查看其拥有使用权限（USAGE_PRIV）的计算组
- 如果用户没有任何计算组的使用权限，则返回结果为空
SHOW COMPUTE GROUPS;
添加计算组
操作计算组需要具备 OPERATOR 权限，即节点管理权限。有关详细信息，请参阅权限管理。默认情况下，只有 root 账号拥有 OPERATOR 权限，但可以通过 GRANT 命令将此权限授予其他账号。
要添加 BE 并为其指定计算组，请使用 Add BE 命令。例如：
ALTER SYSTEM ADD BACKEND 'host:9050' PROPERTIES ("tag.compute_group_name" = "new_group");
上面命令会将host:9050这台节点添加到new_group这个计算组中，您也可以不指定计算组，默认会添加到default_compute_group组里，示例：
ALTER SYSTEM ADD BACKEND 'host:9050';
授予计算组访问权限
前置条件：当前操作用户具备 ADMIN 权限，或者当前用户属于 admin role。
GRANT USAGE_PRIV ON COMPUTE GROUP {compute_group_name} TO {user}
撤销计算组访问权限
前置条件：当前操作用户具备 ADMIN 权限，或者当前用户属于 admin role。
REVOKE USAGE_PRIV ON COMPUTE GROUP {compute_group_name} FROM {user}
设置默认计算组
为当前用户设置默认计算组（此操作需要当前用户已经拥有计算组的使用权限）：
SET PROPERTY 'default_compute_group' = '{clusterName}';
为其他用户设置默认计算组（此操作需要 Admin 权限）：
SET PROPERTY FOR {user} 'default_compute_group' = '{clusterName}';
查看当前用户默认计算组，返回结果中default_compute_group 的值即为默认计算组：
SHOW PROPERTY;
查看其他用户默认计算组，此操作需要当前用户具备 admin 权限，返回结果中default_compute_group 的值即为默认计算组：
SHOW PROPERTY FOR {user};
查看当前仓库下所有可用的计算组：
SHOW COMPUTE GROUPS;
- 若当前用户拥有 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语句来更新默认集群设置。
切换计算组
用户可在存算分离架构中指定使用的数据库和计算组。
语法
USE { [catalog_name.]database_name[@compute_group_name] | @compute_group_name }
若数据库或计算组名称包含是保留关键字，需用反引号将相应的名称 ``` 包围。
计算组扩缩容
通过 ALTER SYSTEM ADD BACKEND 以及 ALTER SYSTEM DECOMMISION BACKEND 添加或者删除 BE 实现计算组的扩缩容。
计算组扩缩容后负载重均衡
Cloud rebalance 是 Doris 在存算分离架构下，当不同 Compute Group 中的后端节点（Backend）发生扩缩容（长时间节点下线视为缩容）后，用于重新均衡集群读写流量的负载均衡操作。
Balance 策略类型
balance_type 功能自 Doris 3.1.3 和 Doris 4.0.2 版本起支持。
在此之前，仅支持通过 FE 全局配置 enable_cloud_warm_up_for_rebalance 来控制 rebalance 时是否执行 warm up 任务。
以下以向 Compute Group 扩容节点为例，说明三种策略类型：
| 类型 | 新节点可服务时间 | 性能波动 | 技术原理 | 适用场景 |
|---|---|---|---|---|
without_warmup | 最快 | 性能波动最大 | FE 直接修改分片映射；首次读写无 file cache，需从 S3 拉取数据 | 需要新节点快速上线，对性能抖动不敏感的场景 |
async_warmup | 较快 | 可能出现 cache miss | 下发 warm up 任务，成功或超时后再修改映射；在映射切换时尽力拉取 file cache 到新 BE，部分场景首次读仍可能 miss | 通用场景，性能可接受 |
sync_warmup | 较慢 | 基本无 cache miss | 下发 warm up 任务，FE 确认任务完成后才修改映射，确保 cache 迁移完成 | 对扩容后性能要求极高，希望新节点上一定存在 file cache 的场景 |
用户接口
全局默认 balance type
通过 FE 配置项(fe.conf)设置全局默认值：
cloud_default_rebalance_type = "async_warmup"
Compute Group 维度配置
支持为每个 Compute Group 单独配置 balance type：
ALTER COMPUTE GROUP cg1 PROPERTIES("balance_type"="async_warmup");
配置规则
- 若 Compute Group 未配置
balance_type，则使用全局默认值async_warmup。 - 若 Compute Group 已配置
balance_type，则执行 rebalance 时优先使用该 Compute Group 的配置。
FAQ
如何查看与修改全局 rebalance type？
- 查看：执行
ADMIN SHOW FRONTEND CONFIG LIKE "cloud_default_rebalance_type"; - 修改：执行
ADMIN SET FRONTEND CONFIG ("cloud_warm_up_for_rebalance_type" = "without_warmup");（修改后无需重启 FE 即可生效）
如何查询 Compute Group 的 balance type？
执行 SHOW COMPUTE GROUPS;，结果中的 properties 列包含 Compute Group 的属性信息，其中可查看 balance_type 配置。
如何判断集群是否处于 tablet 稳定态？
-
通过
SHOW BACKENDS查看：检查各 BE 的 tablet 数是否接近。计算方法参考范围：(集群所有 tablet 数 / Compute Group BE 数) * 0.95
~
(集群所有 tablet 数 / Compute Group BE 数) * 1.05其中 0.05 为 FE 配置项
cloud_rebalance_percent_threshold的默认值。如需让 Compute Group 中各 BE 承载的 tablet 更加均匀，可调小该配置值。 -
通过 FE metrics 观察：查看 FE metrics 中的
doris_fe_cloud_.*_balance_num系列指标，若长时间无变化，说明 Compute Group 已趋于均衡状态。建议在监控面板上配置这些 metrics，便于持续观察和判断。curl "http://feip:fe_http_port/metrics" | grep '_balance_num'
重命名计算组
您可以使用 ALTER SYSTEM RENAME COMPUTE GROUP <old_name> <new_name> 命令来重命名现有的计算组。请参阅重命名计算组 SQL 手册
注意 在重命名计算组后，拥有旧名称（old_name）计算组权限的用户，或将旧名称设置为默认计算组（default_compute_group）的用户，其权限不会自动更新为新名称（new_name）。需要由具有管理员权限的账户重新设置权限。这与 MySQL 数据库的权限体系保持一致。
