From 0405e4b95e966febc3172de2a37893fc4c973562 Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Mon, 12 Jan 2026 10:58:51 +0800 Subject: [PATCH 1/7] Add temp.md --- temp.md | 1 + 1 file changed, 1 insertion(+) create mode 100644 temp.md diff --git a/temp.md b/temp.md new file mode 100644 index 0000000000000..af27ff4986a7b --- /dev/null +++ b/temp.md @@ -0,0 +1 @@ +This is a test file. \ No newline at end of file From 1edbf2d1b8f15f0d4a3b9e3f3a097cf9a549bd98 Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Mon, 12 Jan 2026 10:58:56 +0800 Subject: [PATCH 2/7] Delete temp.md --- temp.md | 1 - 1 file changed, 1 deletion(-) delete mode 100644 temp.md diff --git a/temp.md b/temp.md deleted file mode 100644 index af27ff4986a7b..0000000000000 --- a/temp.md +++ /dev/null @@ -1 +0,0 @@ -This is a test file. \ No newline at end of file From 55bd1457885d1e05f4f7438abe46e100315c0ecf Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Mon, 12 Jan 2026 03:00:01 +0000 Subject: [PATCH 3/7] Auto-sync: Update English docs from Chinese PR Synced from: https://github.com/pingcap/docs-cn/pull/21244 Target PR: https://github.com/pingcap/docs/pull/22296 AI Provider: gemini Co-authored-by: github-actions[bot] --- tikv-configuration-file.md | 20 ++++++++++++++++---- 1 file changed, 16 insertions(+), 4 deletions(-) diff --git a/tikv-configuration-file.md b/tikv-configuration-file.md index a2ea81b9af2f6..f602855df793c 100644 --- a/tikv-configuration-file.md +++ b/tikv-configuration-file.md @@ -570,12 +570,20 @@ Configuration items related to the flow control mechanism in TiKV. This mechanis ### `l0-files-threshold` -+ When the number of kvDB L0 files reaches this threshold, the flow control mechanism starts to work. When `enable` is set to `true`, this configuration item overrides `rocksdb.(defaultcf|writecf|lockcf).level0-slowdown-writes-trigger`. ++ When the number of kvDB L0 files reaches this threshold, the flow control mechanism starts to work. + + > **Note**: + > + > When certain conditions are met, `rocksdb.(defaultcf|writecf|lockcf|raftcf).level0-slowdown-writes-trigger` will be overridden by this configuration item. For details, refer to [`rocksdb.(defaultcf|writecf|lockcf|raftcf).level0-slowdown-writes-trigger`](/tikv-configuration-file.md#level0-slowdown-writes-trigger). + Default value: `20` ### `soft-pending-compaction-bytes-limit` -+ When the pending compaction bytes in KvDB reach this threshold, the flow control mechanism starts to reject some write requests and reports the `ServerIsBusy` error. When `enable` is set to `true`, this configuration item overrides `rocksdb.(defaultcf|writecf|lockcf).soft-pending-compaction-bytes-limit`. ++ When the pending compaction bytes in KvDB reach this threshold, the flow control mechanism starts to reject some write requests and reports the `ServerIsBusy` error. + + > **Note**: + > + > When certain conditions are met, `rocksdb.(defaultcf|writecf|lockcf|raftcf).soft-pending-compaction-bytes-limit` will be overridden by this configuration item. For details, refer to [`rocksdb.(defaultcf|writecf|lockcf|raftcf).soft-pending-compaction-bytes-limit`](/tikv-configuration-file.md#soft-pending-compaction-bytes-limit-1). + Default value: `"192GiB"` ### `hard-pending-compaction-bytes-limit` @@ -1638,7 +1646,9 @@ Configuration items related to `rocksdb.defaultcf`, `rocksdb.writecf`, and `rock ### `level0-slowdown-writes-trigger` -+ The maximum number of files at L0 that trigger write stall. When `storage.flow-control.enable` is set to `true`, `storage.flow-control.l0-files-threshold` overrides this configuration item. ++ The maximum number of files at L0 that trigger write stall. ++ Versions v8.5.4 and earlier: When the flow control mechanism is enabled ([`storage.flow-control.enable`](/tikv-configuration-file.md#enable) is `true`), this configuration item is directly overridden by [`storage.flow-control.l0-files-threshold`](/tikv-configuration-file.md#l0-files-threshold). ++ Starting from v8.5.5 and v9.0.0: When the flow control mechanism is enabled ([`storage.flow-control.enable`](/tikv-configuration-file.md#enable) is `true`), this configuration item is overridden by [`storage.flow-control.l0-files-threshold`](/tikv-configuration-file.md#l0-files-threshold) only when its value is greater than [`storage.flow-control.l0-files-threshold`](/tikv-configuration-file.md#l0-files-threshold), to prevent weakening RocksDB's compaction acceleration mechanism when increasing the flow control threshold. + Default value: `20` + Minimum value: `0` @@ -1694,7 +1704,9 @@ Configuration items related to `rocksdb.defaultcf`, `rocksdb.writecf`, and `rock ### `soft-pending-compaction-bytes-limit` -+ The soft limit on the pending compaction bytes. When `storage.flow-control.enable` is set to `true`, `storage.flow-control.soft-pending-compaction-bytes-limit` overrides this configuration item. ++ The soft limit on the pending compaction bytes. ++ Versions v8.5.4 and earlier: When the flow control mechanism is enabled ([`storage.flow-control.enable`](/tikv-configuration-file.md#enable) is `true`), this configuration item is directly overridden by [`storage.flow-control.soft-pending-compaction-bytes-limit`](/tikv-configuration-file.md#soft-pending-compaction-bytes-limit). ++ Starting from v8.5.5 and v9.0.0: When the flow control mechanism is enabled ([`storage.flow-control.enable`](/tikv-configuration-file.md#enable) is `true`), this configuration item is overridden by [`storage.flow-control.soft-pending-compaction-bytes-limit`](/tikv-configuration-file.md#soft-pending-compaction-bytes-limit) only when its value is greater than [`storage.flow-control.soft-pending-compaction-bytes-limit`](/tikv-configuration-file.md#soft-pending-compaction-bytes-limit), to prevent weakening RocksDB's compaction acceleration mechanism when increasing the flow control threshold. + Default value: `"192GiB"` + Unit: KiB|MiB|GiB From 5a8ffd817d42f41007240c6620fd0727bf7b86dc Mon Sep 17 00:00:00 2001 From: qiancai Date: Mon, 12 Jan 2026 11:26:56 +0800 Subject: [PATCH 4/7] Update tikv-configuration-file.md --- tikv-configuration-file.md | 22 ++++++++++++---------- 1 file changed, 12 insertions(+), 10 deletions(-) diff --git a/tikv-configuration-file.md b/tikv-configuration-file.md index f602855df793c..38379bccf7a98 100644 --- a/tikv-configuration-file.md +++ b/tikv-configuration-file.md @@ -572,18 +572,20 @@ Configuration items related to the flow control mechanism in TiKV. This mechanis + When the number of kvDB L0 files reaches this threshold, the flow control mechanism starts to work. - > **Note**: - > - > When certain conditions are met, `rocksdb.(defaultcf|writecf|lockcf|raftcf).level0-slowdown-writes-trigger` will be overridden by this configuration item. For details, refer to [`rocksdb.(defaultcf|writecf|lockcf|raftcf).level0-slowdown-writes-trigger`](/tikv-configuration-file.md#level0-slowdown-writes-trigger). + > **Note:** + > + > Under certain conditions, this configuration item can override the value of `rocksdb.(defaultcf|writecf|lockcf|raftcf).level0-slowdown-writes-trigger`. For more information, see [`rocksdb.(defaultcf|writecf|lockcf|raftcf).level0-slowdown-writes-trigger`](/tikv-configuration-file.md#level0-slowdown-writes-trigger). + + Default value: `20` ### `soft-pending-compaction-bytes-limit` + When the pending compaction bytes in KvDB reach this threshold, the flow control mechanism starts to reject some write requests and reports the `ServerIsBusy` error. - > **Note**: - > - > When certain conditions are met, `rocksdb.(defaultcf|writecf|lockcf|raftcf).soft-pending-compaction-bytes-limit` will be overridden by this configuration item. For details, refer to [`rocksdb.(defaultcf|writecf|lockcf|raftcf).soft-pending-compaction-bytes-limit`](/tikv-configuration-file.md#soft-pending-compaction-bytes-limit-1). + > **Note:** + > + > Under certain conditions, this configuration item can override the value of `rocksdb.(defaultcf|writecf|lockcf|raftcf).soft-pending-compaction-bytes-limit`. For more information, see [`rocksdb.(defaultcf|writecf|lockcf|raftcf).soft-pending-compaction-bytes-limit`](/tikv-configuration-file.md#soft-pending-compaction-bytes-limit-1). + + Default value: `"192GiB"` ### `hard-pending-compaction-bytes-limit` @@ -1647,8 +1649,8 @@ Configuration items related to `rocksdb.defaultcf`, `rocksdb.writecf`, and `rock ### `level0-slowdown-writes-trigger` + The maximum number of files at L0 that trigger write stall. -+ Versions v8.5.4 and earlier: When the flow control mechanism is enabled ([`storage.flow-control.enable`](/tikv-configuration-file.md#enable) is `true`), this configuration item is directly overridden by [`storage.flow-control.l0-files-threshold`](/tikv-configuration-file.md#l0-files-threshold). -+ Starting from v8.5.5 and v9.0.0: When the flow control mechanism is enabled ([`storage.flow-control.enable`](/tikv-configuration-file.md#enable) is `true`), this configuration item is overridden by [`storage.flow-control.l0-files-threshold`](/tikv-configuration-file.md#l0-files-threshold) only when its value is greater than [`storage.flow-control.l0-files-threshold`](/tikv-configuration-file.md#l0-files-threshold), to prevent weakening RocksDB's compaction acceleration mechanism when increasing the flow control threshold. ++ In v8.5.4 and earlier versions: when the flow control mechanism is enabled ([`storage.flow-control.enable`](/tikv-configuration-file.md#enable) is `true`), the value of this configuration item is directly overridden by [`storage.flow-control.l0-files-threshold`](/tikv-configuration-file.md#l0-files-threshold). ++ Starting from v8.5.5 and v9.0.0: when the flow control mechanism is enabled ([`storage.flow-control.enable`](/tikv-configuration-file.md#enable) is `true`), the value of this configuration item is overridden by [`storage.flow-control.l0-files-threshold`](/tikv-configuration-file.md#l0-files-threshold) only when its value is greater than [`storage.flow-control.l0-files-threshold`](/tikv-configuration-file.md#l0-files-threshold). This behavior prevents weakening RocksDB’s compaction acceleration mechanism when you increase the flow control threshold. + Default value: `20` + Minimum value: `0` @@ -1705,8 +1707,8 @@ Configuration items related to `rocksdb.defaultcf`, `rocksdb.writecf`, and `rock ### `soft-pending-compaction-bytes-limit` + The soft limit on the pending compaction bytes. -+ Versions v8.5.4 and earlier: When the flow control mechanism is enabled ([`storage.flow-control.enable`](/tikv-configuration-file.md#enable) is `true`), this configuration item is directly overridden by [`storage.flow-control.soft-pending-compaction-bytes-limit`](/tikv-configuration-file.md#soft-pending-compaction-bytes-limit). -+ Starting from v8.5.5 and v9.0.0: When the flow control mechanism is enabled ([`storage.flow-control.enable`](/tikv-configuration-file.md#enable) is `true`), this configuration item is overridden by [`storage.flow-control.soft-pending-compaction-bytes-limit`](/tikv-configuration-file.md#soft-pending-compaction-bytes-limit) only when its value is greater than [`storage.flow-control.soft-pending-compaction-bytes-limit`](/tikv-configuration-file.md#soft-pending-compaction-bytes-limit), to prevent weakening RocksDB's compaction acceleration mechanism when increasing the flow control threshold. ++ In v8.5.4 and earlier versions: when the flow control mechanism is enabled ([`storage.flow-control.enable`](/tikv-configuration-file.md#enable) is `true`), this configuration item is directly overridden by [`storage.flow-control.soft-pending-compaction-bytes-limit`](/tikv-configuration-file.md#soft-pending-compaction-bytes-limit). ++ Starting from v8.5.5 and v9.0.0: when the flow control mechanism is enabled ([`storage.flow-control.enable`](/tikv-configuration-file.md#enable) is `true`), this configuration item is overridden by [`storage.flow-control.soft-pending-compaction-bytes-limit`](/tikv-configuration-file.md#soft-pending-compaction-bytes-limit) only when its value is greater than [`storage.flow-control.soft-pending-compaction-bytes-limit`](/tikv-configuration-file.md#soft-pending-compaction-bytes-limit). This behavior prevents weakening RocksDB’s compaction acceleration mechanism when you increase the flow control threshold. + Default value: `"192GiB"` + Unit: KiB|MiB|GiB From d01ce9c3b5ec0b5ad4d6305ff20259271beddc67 Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Tue, 13 Jan 2026 11:25:08 +0800 Subject: [PATCH 5/7] Apply suggestions from code review Co-authored-by: Aolin --- tikv-configuration-file.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/tikv-configuration-file.md b/tikv-configuration-file.md index 38379bccf7a98..4396b59b0731f 100644 --- a/tikv-configuration-file.md +++ b/tikv-configuration-file.md @@ -1650,7 +1650,7 @@ Configuration items related to `rocksdb.defaultcf`, `rocksdb.writecf`, and `rock + The maximum number of files at L0 that trigger write stall. + In v8.5.4 and earlier versions: when the flow control mechanism is enabled ([`storage.flow-control.enable`](/tikv-configuration-file.md#enable) is `true`), the value of this configuration item is directly overridden by [`storage.flow-control.l0-files-threshold`](/tikv-configuration-file.md#l0-files-threshold). -+ Starting from v8.5.5 and v9.0.0: when the flow control mechanism is enabled ([`storage.flow-control.enable`](/tikv-configuration-file.md#enable) is `true`), the value of this configuration item is overridden by [`storage.flow-control.l0-files-threshold`](/tikv-configuration-file.md#l0-files-threshold) only when its value is greater than [`storage.flow-control.l0-files-threshold`](/tikv-configuration-file.md#l0-files-threshold). This behavior prevents weakening RocksDB’s compaction acceleration mechanism when you increase the flow control threshold. ++ Starting from v8.5.5 and v9.0.0: when the flow control mechanism is enabled ([`storage.flow-control.enable`](/tikv-configuration-file.md#enable) is `true`), the value of this configuration item is overridden by [`storage.flow-control.l0-files-threshold`](/tikv-configuration-file.md#l0-files-threshold) only when its value is greater than [`storage.flow-control.l0-files-threshold`](/tikv-configuration-file.md#l0-files-threshold). This behavior prevents weakening RocksDB's compaction acceleration mechanism when you increase the flow control threshold. + Default value: `20` + Minimum value: `0` @@ -1708,7 +1708,7 @@ Configuration items related to `rocksdb.defaultcf`, `rocksdb.writecf`, and `rock + The soft limit on the pending compaction bytes. + In v8.5.4 and earlier versions: when the flow control mechanism is enabled ([`storage.flow-control.enable`](/tikv-configuration-file.md#enable) is `true`), this configuration item is directly overridden by [`storage.flow-control.soft-pending-compaction-bytes-limit`](/tikv-configuration-file.md#soft-pending-compaction-bytes-limit). -+ Starting from v8.5.5 and v9.0.0: when the flow control mechanism is enabled ([`storage.flow-control.enable`](/tikv-configuration-file.md#enable) is `true`), this configuration item is overridden by [`storage.flow-control.soft-pending-compaction-bytes-limit`](/tikv-configuration-file.md#soft-pending-compaction-bytes-limit) only when its value is greater than [`storage.flow-control.soft-pending-compaction-bytes-limit`](/tikv-configuration-file.md#soft-pending-compaction-bytes-limit). This behavior prevents weakening RocksDB’s compaction acceleration mechanism when you increase the flow control threshold. ++ Starting from v8.5.5 and v9.0.0: when the flow control mechanism is enabled ([`storage.flow-control.enable`](/tikv-configuration-file.md#enable) is `true`), this configuration item is overridden by [`storage.flow-control.soft-pending-compaction-bytes-limit`](/tikv-configuration-file.md#soft-pending-compaction-bytes-limit) only when its value is greater than [`storage.flow-control.soft-pending-compaction-bytes-limit`](/tikv-configuration-file.md#soft-pending-compaction-bytes-limit). This behavior prevents weakening RocksDB's compaction acceleration mechanism when you increase the flow control threshold. + Default value: `"192GiB"` + Unit: KiB|MiB|GiB From 02c7848473e049175d7e06c3fbe0334335c7000d Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Tue, 13 Jan 2026 11:26:41 +0800 Subject: [PATCH 6/7] minor wording updates --- tikv-configuration-file.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/tikv-configuration-file.md b/tikv-configuration-file.md index 4396b59b0731f..a4ba528e7fa78 100644 --- a/tikv-configuration-file.md +++ b/tikv-configuration-file.md @@ -574,7 +574,7 @@ Configuration items related to the flow control mechanism in TiKV. This mechanis > **Note:** > - > Under certain conditions, this configuration item can override the value of `rocksdb.(defaultcf|writecf|lockcf|raftcf).level0-slowdown-writes-trigger`. For more information, see [`rocksdb.(defaultcf|writecf|lockcf|raftcf).level0-slowdown-writes-trigger`](/tikv-configuration-file.md#level0-slowdown-writes-trigger). + > Under specific conditions, this configuration item can override the value of `rocksdb.(defaultcf|writecf|lockcf|raftcf).level0-slowdown-writes-trigger`. For more information, see [`rocksdb.(defaultcf|writecf|lockcf|raftcf).level0-slowdown-writes-trigger`](/tikv-configuration-file.md#level0-slowdown-writes-trigger). + Default value: `20` @@ -584,7 +584,7 @@ Configuration items related to the flow control mechanism in TiKV. This mechanis > **Note:** > - > Under certain conditions, this configuration item can override the value of `rocksdb.(defaultcf|writecf|lockcf|raftcf).soft-pending-compaction-bytes-limit`. For more information, see [`rocksdb.(defaultcf|writecf|lockcf|raftcf).soft-pending-compaction-bytes-limit`](/tikv-configuration-file.md#soft-pending-compaction-bytes-limit-1). + > Under specific conditions, this configuration item can override the value of `rocksdb.(defaultcf|writecf|lockcf|raftcf).soft-pending-compaction-bytes-limit`. For more information, see [`rocksdb.(defaultcf|writecf|lockcf|raftcf).soft-pending-compaction-bytes-limit`](/tikv-configuration-file.md#soft-pending-compaction-bytes-limit-1). + Default value: `"192GiB"` From 18b98bea1edbde700ad545223cd820fbc7c06310 Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Tue, 13 Jan 2026 11:28:33 +0800 Subject: [PATCH 7/7] Apply suggestions from code review --- tikv-configuration-file.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/tikv-configuration-file.md b/tikv-configuration-file.md index a4ba528e7fa78..b3a55de3e6b01 100644 --- a/tikv-configuration-file.md +++ b/tikv-configuration-file.md @@ -1650,7 +1650,7 @@ Configuration items related to `rocksdb.defaultcf`, `rocksdb.writecf`, and `rock + The maximum number of files at L0 that trigger write stall. + In v8.5.4 and earlier versions: when the flow control mechanism is enabled ([`storage.flow-control.enable`](/tikv-configuration-file.md#enable) is `true`), the value of this configuration item is directly overridden by [`storage.flow-control.l0-files-threshold`](/tikv-configuration-file.md#l0-files-threshold). -+ Starting from v8.5.5 and v9.0.0: when the flow control mechanism is enabled ([`storage.flow-control.enable`](/tikv-configuration-file.md#enable) is `true`), the value of this configuration item is overridden by [`storage.flow-control.l0-files-threshold`](/tikv-configuration-file.md#l0-files-threshold) only when its value is greater than [`storage.flow-control.l0-files-threshold`](/tikv-configuration-file.md#l0-files-threshold). This behavior prevents weakening RocksDB's compaction acceleration mechanism when you increase the flow control threshold. ++ Starting from v8.5.5 and v9.0.0: when the flow control mechanism is enabled ([`storage.flow-control.enable`](/tikv-configuration-file.md#enable) is `true`), the value of this configuration item is overridden by [`storage.flow-control.l0-files-threshold`](/tikv-configuration-file.md#l0-files-threshold) only when its value is greater than `storage.flow-control.l0-files-threshold`. This behavior prevents weakening RocksDB's compaction acceleration mechanism when you increase the flow control threshold. + Default value: `20` + Minimum value: `0` @@ -1708,7 +1708,7 @@ Configuration items related to `rocksdb.defaultcf`, `rocksdb.writecf`, and `rock + The soft limit on the pending compaction bytes. + In v8.5.4 and earlier versions: when the flow control mechanism is enabled ([`storage.flow-control.enable`](/tikv-configuration-file.md#enable) is `true`), this configuration item is directly overridden by [`storage.flow-control.soft-pending-compaction-bytes-limit`](/tikv-configuration-file.md#soft-pending-compaction-bytes-limit). -+ Starting from v8.5.5 and v9.0.0: when the flow control mechanism is enabled ([`storage.flow-control.enable`](/tikv-configuration-file.md#enable) is `true`), this configuration item is overridden by [`storage.flow-control.soft-pending-compaction-bytes-limit`](/tikv-configuration-file.md#soft-pending-compaction-bytes-limit) only when its value is greater than [`storage.flow-control.soft-pending-compaction-bytes-limit`](/tikv-configuration-file.md#soft-pending-compaction-bytes-limit). This behavior prevents weakening RocksDB's compaction acceleration mechanism when you increase the flow control threshold. ++ Starting from v8.5.5 and v9.0.0: when the flow control mechanism is enabled ([`storage.flow-control.enable`](/tikv-configuration-file.md#enable) is `true`), this configuration item is overridden by [`storage.flow-control.soft-pending-compaction-bytes-limit`](/tikv-configuration-file.md#soft-pending-compaction-bytes-limit) only when its value is greater than `storage.flow-control.soft-pending-compaction-bytes-limit`. This behavior prevents weakening RocksDB's compaction acceleration mechanism when you increase the flow control threshold. + Default value: `"192GiB"` + Unit: KiB|MiB|GiB