diff --git a/best-practices/massive-regions-best-practices.md b/best-practices/massive-regions-best-practices.md index 335754be96e42..bc15cc6633b3b 100644 --- a/best-practices/massive-regions-best-practices.md +++ b/best-practices/massive-regions-best-practices.md @@ -67,7 +67,7 @@ By default, `raftstore.store-pool-size` is configured to `2` in TiKV. If a bottl In the actual situation, read and write requests are not evenly distributed on every Region. Instead, they are concentrated on a few Regions. Then you can minimize the number of messages between the Raft leader and the followers for the temporarily idle Regions, which is the feature of Hibernate Region. In this feature, Raftstore does sent tick messages to the Raft state machines of idle Regions if not necessary. Then these Raft state machines will not be triggered to generate heartbeat messages, which can greatly reduce the workload of Raftstore. -Hibernate Region is enabled by default in [TiKV master](https://github.com/tikv/tikv/tree/master). You can enable this feature according to your needs. For the configuration of Hibernate Region, refer to [Configure Hibernate Region](/tikv-configuration-file.md#hibernate-regions-experimental). +Hibernate Region is enabled by default in [TiKV master](https://github.com/tikv/tikv/tree/master). You can configure this feature according to your needs. For details, refer to [Configure Hibernate Region](/tikv-configuration-file.md). ### Method 3: Enable `Region Merge` diff --git a/experimental-features.md b/experimental-features.md index 33dbdf275df7a..2af5b55fed868 100644 --- a/experimental-features.md +++ b/experimental-features.md @@ -14,7 +14,6 @@ This document introduces the experimental features of TiDB in different versions + Improve the stability of the optimizer's choice of indexes (Introduced in v5.0) + Extend the statistics feature by collecting the multi-column order dependency information. + Refactor the statistics module, including deleting the `TopN` value from `CMSKetch` and the histogram, and adding NDV information for histogram buckets of each table index. -+ [hibernate-regions](/tikv-configuration-file.md#hibernate-regions-experimental). A Region that idles for a long time is automatically set as hibernated. This reduces the extra overhead caused by heartbeat messages between the Raft leader and the followers for idle Regions. ## Scheduling diff --git a/system-variables.md b/system-variables.md index 3593473c3665b..af2fda2fe7dcc 100644 --- a/system-variables.md +++ b/system-variables.md @@ -653,7 +653,7 @@ For a system upgraded to v5.0 from an earlier version, if you have not modified - Possible values: - `LEGACY`: Uses the old way of scanning, that is, disable Green GC. - `PHYSICAL`: Uses the physical scanning method, that is, enable Green GC. -- This parameter specifies the way of scanning locks in the Resolve Locks step of GC. When set to `LEGACY`, TiDB scans locks by Regions. The value `PHYSICAL` enables each TiKV node to bypass the Raft layer and directly scan data. This feature can effectively mitigate the impact of GC wakening up all Regions when the [Hibernate Region](/tikv-configuration-file.md#hibernate-regions-experimental) feature is enabled, thus improving the execution speed in the Resolve Locks step. +- This variable specifies the way of scanning locks in the Resolve Locks step of GC. When the variable value is set to `LEGACY`, TiDB scans locks by Regions. When the value `PHYSICAL` is used, it enables each TiKV node to bypass the Raft layer and directly scan data, which can effectively mitigate the impact of GC wakening up all Regions when the [Hibernate Region](/tikv-configuration-file.md#hibernate-regions) feature is enabled, thus improving the execution speed in the Resolve Locks step. ### tidb_general_log diff --git a/ticdc/ticdc-overview.md b/ticdc/ticdc-overview.md index 36fe3e6253db3..d3f0b23e86088 100644 --- a/ticdc/ticdc-overview.md +++ b/ticdc/ticdc-overview.md @@ -86,8 +86,7 @@ Since v4.0.8, TiCDC supports replicating tables **without a valid index** by mod Currently, The following scenarios are not supported: - The TiKV cluster that uses RawKV alone. -- The [DDL operation `CREATE SEQUENCE`](/sql-statements/sql-statement-create-sequence.md) and the [SEQUENCE function](/sql-statements/sql-statement-create-sequence.md#sequence-function) in TiDB v4.0. When the upstream TiDB uses `SEQUENCE`, TiCDC ignores `SEQUENCE` DDL operations/functions performed upstream. However, DML operations using `SEQUENCE` functions can be correctly replicated. -- The [TiKV Hibernate Region](/best-practices/massive-regions-best-practices.md#method-2-enable-hibernate-region). TiCDC prevents the Region from entering the hibernated state. +- The [DDL operation `CREATE SEQUENCE`](/sql-statements/sql-statement-create-sequence.md) and the [SEQUENCE function](/sql-statements/sql-statement-create-sequence.md#sequence-function) in TiDB. When the upstream TiDB uses `SEQUENCE`, TiCDC ignores `SEQUENCE` DDL operations/functions performed upstream. However, DML operations using `SEQUENCE` functions can be correctly replicated. TiCDC only provides partial support for scenarios of large transactions in the upstream. For details, refer to [FAQ: Does TiCDC support replicating large transactions? Is there any risk?](/ticdc/troubleshoot-ticdc.md#does-ticdc-support-replicating-large-transactions-is-there-any-risk). diff --git a/tikv-configuration-file.md b/tikv-configuration-file.md index 314205a2f8fd6..da09a48887e13 100644 --- a/tikv-configuration-file.md +++ b/tikv-configuration-file.md @@ -410,10 +410,10 @@ Configuration items related to Raftstore + Default value: `"3s"` + Minimum value: `0` -### `hibernate-regions` (**Experimental**) +### `hibernate-regions` + Enables or disables Hibernate Region. When this option is enabled, a Region idle for a long time is automatically set as hibernated. This reduces the extra overhead caused by heartbeat messages between the Raft leader and the followers for idle Regions. You can use `raftstore.peer-stale-state-check-interval` to modify the heartbeat interval between the leader and the followers of hibernated Regions. -+ Default value: false ++ Default value: `true` in v5.0.2 and later versions; `false` in versions before v5.0.2 ### `raftstore.peer-stale-state-check-interval`