Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

tikv: recorrect the descriptions on the feature region-split-size part. #15600

Merged
merged 10 commits into from
Dec 22, 2023
+15 −9
Merged

tikv: recorrect the descriptions on the feature region-split-size part. #15600

Changes from 1 commit
Commits
Show all changes
10 commits
Select commit Hold shift + click to select a range
eb2abe7
Recorrect the descriptions on the feature `region-split-size` part.
LykxSassinator Dec 5, 2023
ff629f2
Address comments.
LykxSassinator Dec 5, 2023
038f51e
Polish annotations.
LykxSassinator Dec 5, 2023
012bc61
Apply suggestions from code review
LykxSassinator Dec 6, 2023
d1e4c4d
minor wording updates
qiancai Dec 6, 2023
e62787d
Supplement extra annotations for `region-split-size`.
LykxSassinator Dec 8, 2023
bac9f5a
Apply suggestions from code review
LykxSassinator Dec 22, 2023
9686759
Update releases/release-6.1.0.md
LykxSassinator Dec 22, 2023
4be783c
Update releases/release-6.1.0.md
qiancai Dec 22, 2023
7408c73
Update releases/release-6.1.0.md
qiancai Dec 22, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
Apply suggestions from code review 
Co-authored-by: Grace Cai <qqzczy@126.com>
  • Loading branch information
@LykxSassinator @qiancai
LykxSassinator and qiancai authored Dec 6, 2023
commit 012bc6105768152135b2ddd0652a172099225e8d
8 changes: 4 additions & 4 deletions tune-region-performance.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,17 +11,17 @@ summary: 了解如何通过调整 Region 大小等方法对 Region 进行性能

TiKV 自动将底层数据进行[分片](/best-practices/tidb-best-practices.md#数据分片)，所有数据按照 key 的范围划分为若干个 Region。当某个 Region 的大小超过一定限制后，TiKV 会将它分裂为多个 Region。

在大量数据的场景下，Region 较小，可能会出现 Region 数量过多，从而带来更多的资源开销和导致[性能回退](/best-practices/massive-regions-best-practices.md#性能问题)的问题。从 v6.1.0 开始，TiDB 支持设置自定义的 Region 大小。Region 默认的大小约为 96 MiB，将其调大可以减少 Region 个数。
在大量数据的场景下，如果 Region 较小，可能会出现 Region 数量过多的情况，从而带来更多的资源开销和导致[性能回退](/best-practices/massive-regions-best-practices.md#性能问题)的问题。从 v6.1.0 开始，TiDB 支持设置自定义的 Region 大小。Region 默认的大小约为 96 MiB，将其调大可以减少 Region 个数。

开启 [Hibernate Region](/best-practices/massive-regions-best-practices.md#方法四开启-hibernate-region-功能) 或 [`Region Merge`](/best-practices/massive-regions-best-practices.md#方法五开启-region-merge) 也可以减少过多 Region 带来的性能开销。

## 使用 `region-split-size` 调整 Region 大小

> **注意：**
>
> Region 大小的推荐值的范围为 [48MiB, 258MiB]，常用大小为 96 MiB、128 MiB、256 MiB。不推荐将 Region 大小设置超过 1 GiB，强烈建议不超过 10 GiB。过大的 Region 可能带来以下影响：
> Region 大小的推荐范围为 [48MiB, 258MiB]，常用的大小包括 96 MiB、128 MiB、256 MiB。不推荐将 Region 大小设置超过 1 GiB，强烈建议不超过 10 GiB。设置过大的 Region 可能带来以下影响：
qiancai marked this conversation as resolved.
Show resolved Hide resolved
>
> + 可能发生性能抖动。
> + 性能抖动。
> + 查询性能回退，尤其是大范围数据查询的性能会有回退。
> + 调度变慢。

Expand All @@ -33,4 +33,4 @@ Region 的大小可以通过 [`coprocessor.region-split-size`](/tikv-configurati
>
> 当前该功能为实验特性，不建议在生产环境中使用。

Region 调大以后，若为了进一步提高查询的并发度，则应当同步设置 [`coprocessor.enable-region-bucket`](/tikv-configuration-file.md#enable-region-bucket-从-v610-版本开始引入) 为 `true`。这个配置会将每个 Region 划分为更小的区间 bucket，并且以这个更小的区间作为并发查询单位，以提高扫描数据的并发度。bucket 的大小通过 [`coprocessor.region-bucket-size`](/tikv-configuration-file.md#region-bucket-size-从-v610-版本开始引入) 来控制。
Region 调大以后，如需进一步提高查询的并发度，可以设置 [`coprocessor.enable-region-bucket`](/tikv-configuration-file.md#enable-region-bucket-从-v610-版本开始引入) 为 `true`。这个配置会将每个 Region 划分为更小的区间 bucket，并且以这个更小的区间作为并发查询单位，以提高扫描数据的并发度。bucket 的大小通过 [`coprocessor.region-bucket-size`](/tikv-configuration-file.md#region-bucket-size-从-v610-版本开始引入) 来控制。