From 54304725c1eafd0e9ac1c9a9129fea4b4f873de9 Mon Sep 17 00:00:00 2001 From: Aolin Date: Wed, 10 Jan 2024 16:28:54 +0800 Subject: [PATCH] tikv: document periodic full compaction (#15749) --- dynamic-config.md | 1 + tikv-configuration-file.md | 14 ++++++++++++++ 2 files changed, 15 insertions(+) diff --git a/dynamic-config.md b/dynamic-config.md index 032f91d59cc8a..a86252d243a61 100644 --- a/dynamic-config.md +++ b/dynamic-config.md @@ -157,6 +157,7 @@ show warnings; | raftstore.apply-max-batch-size | Raft 状态机由 BatchSystem 批量执行数据写入请求，该配置项指定每批可执行请求的最多 Raft 状态机个数。 | | raftstore.store-max-batch-size | Raft 状态机由 BatchSystem 批量执行把日志落盘至磁盘的请求，该配置项指定每批可执行请求的最多 Raft 状态机个数。 | | raftstore.store-io-pool-size | 处理 Raft I/O 任务的线程池中线程的数量，即 StoreWriter 线程池的大小（不支持将该配置项由非零值调整为 0，或者从 0 调整为非零值）| +| raftstore.periodic-full-compact-start-max-cpu | 控制 TiKV 执行周期性全量数据整理时的 CPU 使用率阈值 | | readpool.unified.max-thread-count | 统一处理读请求的线程池最多的线程数量，即 UnifyReadPool 线程池大小 | | readpool.unified.auto-adjust-pool-size | 是否开启自适应调整 UnifyReadPool 的大小 | | coprocessor.split-region-on-table | 开启按 table 分裂 Region 的开关 | diff --git a/tikv-configuration-file.md b/tikv-configuration-file.md index 9dd70ca911e9c..a36c708f84100 100644 --- a/tikv-configuration-file.md +++ b/tikv-configuration-file.md @@ -1030,6 +1030,20 @@ raftstore 相关的配置项。 + 默认值：0.1 + 最小值：0 +### `periodic-full-compact-start-times` 从 v7.6.0 版本开始引入 + +> **警告：** +> +> 周期性全量数据整理目前为实验特性，不建议在生产环境中使用。该功能可能会在未事先通知的情况下发生变化或删除。如果发现 bug，请在 GitHub 上提 [issue](https://github.com/pingcap/tidb/issues) 反馈。 + ++ 设置 TiKV 启动周期性全量数据整理 (Compaction) 的时间。你可以在数组中指定一个或多个时间计划。例如，`periodic-full-compact-start-times = ["03:00", "23:00"]` 表示 TiKV 基于 TiKV 节点的本地时区，在每天凌晨 3 点和晚上 11 点进行全量数据整理。`periodic-full-compact-start-times = ["03:00 +0000", "23:00 +0000"]` 表示 TiKV 在每天 UTC 时间的凌晨 3 点和晚上 11 点进行全量数据整理。 ++ 默认值：`[]`，表示默认情况下禁用周期性全量数据整理。 + +### `periodic-full-compact-start-max-cpu` 从 v7.6.0 版本开始引入 + ++ 控制 TiKV 执行周期性全量数据整理时的 CPU 使用率阈值。 ++ 默认值：`0.1`，表示全量数据整理进程的最大 CPU 使用率为 10%。 + ## coprocessor Coprocessor 相关的配置项。