计算集群管理

功能概述

本功能允许用户对指定的计算集群执行启动、停止、取消作业、修改属性配置和更新集群说明等操作。通过这些操作，用户可以灵活地管理计算资源，以满足不同的业务需求。

语法规范

-- 启动计算集群 ALTER VCLUSTER [IF EXISTS] name RESUME; -- 停止计算集群 ALTER VCLUSTER [IF EXISTS] name SUSPEND [FORCE]; -- 取消计算集群中的所有作业 ALTER VCLUSTER [IF EXISTS] name CANCEL ALL JOBS; -- 修改计算集群属性 ALTER VCLUSTER [IF EXISTS] name SET objectProperties; -- 修改计算集群的说明信息 ALTER VCLUSTER [IF EXISTS] name SET COMMENT '';

修改属性（objectProperties）说明

-- 修改分析型计算集群（ANALYTICS PURPOSE VIRTUAL CLUSTER）适用属性 objectProperties ::= VCLUSTER_SIZE = num MIN_REPLICAS = num MAX_REPLICAS = num AUTO_SUSPEND_IN_SECOND = num AUTO_RESUME = TRUE | FALSE MAX_CONCURRENCY = num QUERY_RUNTIME_LIMIT_IN_SECOND = num PRELOAD_TABLES = "<schema_name>.<table_name>[,<schema_name>.<table_name>,...]" -- 修改通用型计算集群（GENERAL PURPOSE VIRTUAL CLUSTER）适用属性 objectProperties ::= VCLUSTER_SIZE = num | MIN_VCLUSTER_SIZE = num MAX_VCLUSTER_SIZE = num AUTO_SUSPEND_IN_SECOND = num AUTO_RESUME = TRUE | FALSE QUERY_RUNTIME_LIMIT_IN_SECOND = num QUERY_RESOURCE_LIMIT_RATIO = num -- 修改同步型计算集群（INTEGRATION VIRTUAL CLUSTER）适用属性 objectProperties ::= VCLUSTER_SIZE = num | MIN_VCLUSTER_SIZE = num MAX_VCLUSTER_SIZE = num AUTO_SUSPEND_IN_SECOND = num AUTO_RESUME = TRUE | FALSE QUERY_RUNTIME_LIMIT_IN_SECOND = num

参数详解

1. name

指定计算集群的名称。

2. objectProperties

计算集群的属性配置，具体字段及说明如下：

字段名称	字段含义	取值范围	默认值
`VCLUSTER_SIZE` VCLUSTER_SIZE	计算集群规格。通用型和分析型支持 1–256 CRU（分析型须为 2 的 n 次幂）；同步型支持 0.05–256 CRU。	单位为 CRU（Compute Resource Unit）；同步型：0.05–256，步长 0.025；其他类型：1–256。	创建时：同步型 0.25；其他类型 1
`MIN_VCLUSTER_SIZE` MIN_VCLUSTER_SIZE	通用型（GENERAL）和同步型（INTEGRATION）集群适用。计算集群弹缩时的最小规格，需要小于等于 `MAX_VCLUSTER_SIZE` MAX_VCLUSTER_SIZE 。不可与 `VCLUSTER_SIZE` VCLUSTER_SIZE 同时使用。	通用型：1–256；同步型：0.05–256，步长 0.025。单位为 CRU。	无
`MAX_VCLUSTER_SIZE` MAX_VCLUSTER_SIZE	通用型（GENERAL）和同步型（INTEGRATION）集群适用。计算集群弹缩时的最大规格，需要大于等于 `MIN_VCLUSTER_SIZE` MIN_VCLUSTER_SIZE 。不可与 `VCLUSTER_SIZE` VCLUSTER_SIZE 同时使用。	通用型：1–256；同步型：0.05–256，步长 0.025。单位为 CRU。	无
`MIN_REPLICAS` MIN_REPLICAS	计算集群最小实例数。仅适用于分析型计算集群。	1-10	1
`MAX_REPLICAS` MAX_REPLICAS	计算集群最大实例数。仅适用于分析型计算集群。	1-10	1
`AUTO_SUSPEND_IN_SECOND` AUTO_SUSPEND_IN_SECOND	集群自动关闭的空闲时长。单位：秒。-1 表示不自动停止。	-1 或大于等于 0 的整数	600
`AUTO_RESUME` AUTO_RESUME	是否自动恢复。	`TRUE` TRUE \| `FALSE` FALSE	TRUE
`MAX_CONCURRENCY` MAX_CONCURRENCY	每个计算实例可负载的最大并发数。仅适用于分析型计算集群。	1-32	8
`QUERY_RUNTIME_LIMIT_IN_SECOND` QUERY_RUNTIME_LIMIT_IN_SECOND	提交至该集群的作业可执行的最大时长。单位：秒。	大于 0 的整数	86400
`PRELOAD_TABLES` PRELOAD_TABLES	定时或被触发拉取指定表数据到集群本地 SSD 缓存。仅适用于分析型计算集群。	`schema_name.table_name` schema_name.table_name ，多个表名用英文逗号分隔，支持通配符	null
`QUERY_RESOURCE_LIMIT_RATIO` QUERY_RESOURCE_LIMIT_RATIO	单作业资源占比阈值：单个查询任务可使用的 CPU/内存资源不超过集群总资源的指定比例。	`0.0` 0.0 ~ `1.0` 1.0	1.0

注：

VCLUSTER_SIZE

VCLUSTER_SIZE

参数同时支持以 T-shirt size（XSMALL、SMALL、LARGE 等）和以数字（1、2、4、16 等）表达的方式。更多信息详见：计算集群规格代码变更说明

3. 修改通用型集群的弹缩范围

ALTER VCLUSTER [IF EXISTS] <name> SET MIN_VCLUSTER_SIZE = num MAX_VCLUSTER_SIZE = num;

VCLUSTER_SIZE

VCLUSTER_SIZE

、

MIN_VCLUSTER_SIZE

MIN_VCLUSTER_SIZE

和

MAX_VCLUSTER_SIZE

MAX_VCLUSTER_SIZE

不能同时设置。

使用示例

启动名为
```
sample_vc
```
sample_vc
的计算集群：
ALTER VCLUSTER sample_vc RESUME;
停止名为
```
sample_vc
```
sample_vc
的计算集群：
ALTER VCLUSTER sample_vc SUSPEND;
强制停止名为
```
sample_vc
```
sample_vc
的计算集群（立即终止所有运行中的作业）：
ALTER VCLUSTER sample_vc SUSPEND FORCE;
取消名为
```
sample_vc
```
sample_vc
的计算集群中的所有作业：
ALTER VCLUSTER sample_vc CANCEL ALL JOBS;
修改名为
```
sample_vc
```
sample_vc
的计算集群规格为 XSMALL（1 CRU）：
ALTER VCLUSTER sample_vc SET VCLUSTER_SIZE = 1;
修改名为
```
sample_vc
```
sample_vc
的计算集群最大并发数为 4：
ALTER VCLUSTER sample_vc SET MAX_CONCURRENCY = 4;
修改通用型集群
```
sample_vc
```
sample_vc
的弹缩范围（最小 1 CRU，最大 4 CRU）：
ALTER VCLUSTER sample_vc SET MIN_VCLUSTER_SIZE = 1 MAX_VCLUSTER_SIZE = 4;
修改集群自动停止时间为 300 秒：
ALTER VCLUSTER sample_vc SET AUTO_SUSPEND_IN_SECOND = 300;
关闭集群自动停止（永不自动停止）：
ALTER VCLUSTER sample_vc SET AUTO_SUSPEND_IN_SECOND = -1;
修改名为
```
sample_vc
```
sample_vc
的计算集群的说明信息：
ALTER VCLUSTER sample_vc SET COMMENT '这是一个示例计算集群';

联系我们