CALIBRATE RESOURCE

CALIBRATE RESOURCE 语句用于预估并输出当前集群的 Request Unit (RU) 的容量。

语法图

CalibrateResourceStmt

CALIBRATE RESOURCE - 图1

CalibrateOption

CALIBRATE RESOURCE - 图2

1. CalibrateResourceStmt ::= 'CALIBRATE' 'RESOURCE' CalibrateOption

3. CalibrateOption ::=
4. ('START_TIME' 'TIMESTAMP' ('DURATION' stringLit | 'END_TIME' 'TIMESTAMP')?)
5. | ('WORKLOAD' ('TPCC' | 'OLTP_READ_WRITE' | 'OLTP_READ_ONLY' | 'OLTP_WRITE_ONLY'))?

预估方式

TiDB 提供两种预估方式：

根据实际负载估算容量

如果应用已经在线上运行，或者你能够运行实际业务测试，建议利用一段时间的实际负载来预估总容量。为了提高预估准确性，需要遵守以下约束条件：

  • 使用 START_TIME 参数指定预估开始的时间点，格式为 2006-01-02 15:04:05，默认预估结束时间为当前时间。
  • 指定完成 START_TIME 参数后，可以使用 END_TIME 参数指定预估结束时间，或者使用 DURATION 参数指定距离 START_TIME 的预估时间窗口。
  • 时间窗口范围为 10 分钟至 24 小时。
  • 在预估的时间窗口内，TiDB 与 TiKV 的 CPU 利用率不能过低，否则无法进行容量估算。

基于硬件部署估算容量

这种方式主要根据当前的集群配置，结合对不同负载观测的经验值进行预估。由于不同类型的负载对硬件的配比要求不同，相同配置的硬件所输出的容量也会有所不同。这里的 WORKLOAD 参数提供了以下不同的负载类型供选择，默认为 TPCC：

  • TPCC：数据写入较重的负载，根据类似 TPC-C 的负载模型预测。
  • OLTP_WRITE_ONLY：数据写入较重的负载，根据类似 sysbench oltp_write_only 的负载模型预测。
  • OLTP_READ_WRITE：数据读写平衡的负载，根据类似 sysbench oltp_read_write 的负载模型预测。
  • OLTP_READ_ONLY：数据读取较重的负载，根据类似 sysbench oltp_read_only 的负载模型预测。

CALIBRATE RESOURCE - 图3

注意

集群 RU 的容量会随集群的拓扑结构和各个组件软硬件配置的变化而变化，每个集群实际能消耗的 RU 还与实际的负载相关。基于硬件部署估算容量的预估值仅供参考，可能会与实际的最大值存在偏差。建议根据实际负载估算容量。

权限

执行此命令依赖如下配置和权限：

  • tidb_enable_resource_control 需要处于开启状态
  • 需要拥有 SUPER 或者 RESOURCE_GROUP_ADMIN 权限
  • 需要拥有 METRICS_SCHEMA 库下所有表的 SELECT 权限

示例

指定初始时间 START_TIME 和时间窗口 DURATION 大小，根据实际负载查看 RU 容量。

1. CALIBRATE RESOURCE START_TIME '2023-04-18 08:00:00' DURATION '20m';
2. +-------+
3. | QUOTA |
4. +-------+
5. | 27969 |
6. +-------+
7. 1 row in set (0.01 sec)

指定初始时间 START_TIME 和结束时间 END_TIME，根据实际负载查看 RU 容量。

1. CALIBRATE RESOURCE START_TIME '2023-04-18 08:00:00' END_TIME '2023-04-18 08:20:00';
2. +-------+
3. | QUOTA |
4. +-------+
5. | 27969 |
6. +-------+
7. 1 row in set (0.01 sec)

当时间窗口范围 DURATION 不满足 10 分钟至 24 小时的条件，会导致报错提醒。

1. CALIBRATE RESOURCE START_TIME '2023-04-18 08:00:00' DURATION '25h';
2. ERROR 1105 (HY000): the duration of calibration is too long, which could lead to inaccurate output. Please make the duration between 10m0s and 24h0m0s
3. CALIBRATE RESOURCE START_TIME '2023-04-18 08:00:00' DURATION '9m';
4. ERROR 1105 (HY000): the duration of calibration is too short, which could lead to inaccurate output. Please make the duration between 10m0s and 24h0m0s

当时间窗口范围内的负载过低，会导致报错提醒。

1. CALIBRATE RESOURCE START_TIME '2023-04-18 08:00:00' DURATION '60m';
2. ERROR 1105 (HY000): The workload in selected time window is too low, with which TiDB is unable to reach a capacity estimation; please select another time window with higher workload, or calibrate resource by hardware instead

指定 WORKLOAD 查看 RU 容量，默认为 TPCC。

1. CALIBRATE RESOURCE;
2. +-------+
3. | QUOTA |
4. +-------+
5. | 190470 |
6. +-------+
7. 1 row in set (0.01 sec)

9. CALIBRATE RESOURCE WORKLOAD OLTP_WRITE_ONLY;
10. +-------+
11. | QUOTA |
12. +-------+
13. | 27444 |
14. +-------+
15. 1 row in set (0.01 sec)