计算集群 (Warehouse)
TiDB Cloud Lake 的计算集群相关 SQL 命令。
通用规则
- 计算集群命名：长度为 3–63 个字符，只能包含
A-Z、a-z、0-9和-。 - 字符串和标识符：不含空格的裸标识符可以省略引号；否则请使用单引号括起来。语法允许使用关键字或数字/布尔字面量作为名称，但仍会进行运行时校验。
- 数值参数：
nullable_unsigned_number/nullable_signed_number接受整数型或NULL。提供NULL会将该值重置（例如，AUTO_SUSPEND = NULL等同于0）。 - 时间参数：
QUERY_HISTORY使用YYYY-MM-DD HH:MM:SS（UTC 或显式时区）。如果缺少小数秒，则按整秒解释。 - 布尔参数：仅接受
TRUE/FALSE。 WITH关键字：可以出现在整个选项列表之前，也可以出现在每个选项之前。选项之间以空白字符分隔；逗号不属于语法的一部分。
计算集群管理
标签是键值对，用于帮助对计算集群进行分类和组织，类似于 AWS resource tags。常见用途包括：
- 成本分摊：按团队、项目或成本中心跟踪计算集群成本
- 环境标识：将计算集群标记为 dev、staging 或 production
- 团队归属：标识哪个团队拥有或管理某个计算集群
- 自定义元信息：为组织管理目的添加任意元信息
标签键和值都是任意字符串（如果包含空格或特殊字符，则需要用引号括起来）。标签可以：
- 在创建计算集群时通过
WITH TAG (key = 'value', ...)添加 - 之后通过
ALTER WAREHOUSE ... SET TAG key = 'value'修改或新增 - 通过
ALTER WAREHOUSE ... UNSET TAG key删除
标签会在 API 响应中返回，也可以通过 SHOW WAREHOUSES 查看。
标签限制：
- 每个计算集群最多 10 个标签
- 标签名称（key）最大长度：128 个字符
- 标签值最大长度：256 个字符