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
Merged

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

Changes from 3 commits
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
12 changes: 6 additions & 6 deletions tune-region-performance.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,26 +11,26 @@ summary: 了解如何通过调整 Region 大小等方法对 Region 进行性能

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

在大量数据的场景下，可能会出现 Region 数量过多，从而带来更多的资源开销和导致[性能回退](/best-practices/massive-regions-best-practices.md#性能问题)的问题。在固定数据量下，Region 越大，则 Region 个数越少。从 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 个数。
LykxSassinator marked this conversation as resolved.
Show resolved Hide resolved

开启 [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 大小是在 TiDB v6.1.0 引入的实验特性，不建议在生产环境中配置。使用此特性的风险包括：
> Region 大小的推荐值的范围为 [48MiB, 258MiB]，常用大小为 96 MiB、128 MiB、256 MiB。不推荐将 Region 大小设置超过 1 GiB，强烈建议不超过 10 GiB。过大的 Region 可能带来以下影响：
LykxSassinator marked this conversation as resolved.
Show resolved Hide resolved
>
> + 更容易发生性能抖动。
> + 可能发生性能抖动。
LykxSassinator marked this conversation as resolved.
Show resolved Hide resolved
LykxSassinator marked this conversation as resolved.
Show resolved Hide resolved
> + 查询性能回退，尤其是大范围数据查询的性能会有回退。
> + 调度变慢。

Region 的大小可以通过 [`coprocessor.region-split-size`](/tikv-configuration-file.md#region-split-size) 进行设置。推荐的 Region 大小为 96 MiB、128 MiB、256 MiB。`region-split-size` 越大，性能会越容易发生抖动。不推荐将 Region 大小设置超过 1 GiB，强烈建议不超过 10 GiB。如果你使用了 TiFlash，则 Region 大小不能超过 256 MiB。如果使用 Dumpling 工具，则 Region 大小不能超过 1 GiB。Region 调大以后，使用 Dumpling 工具时，需要降低并发，否则 TiDB 会有 OOM 的风险。
Region 的大小可以通过 [`coprocessor.region-split-size`](/tikv-configuration-file.md#region-split-size) 进行设置。如果你使用了 TiFlash，则 Region 大小不能超过 256 MiB。如果使用 Dumpling 工具，则 Region 大小不能超过 1 GiB。Region 调大以后，使用 Dumpling 工具时，需要降低并发，否则 TiDB 会有 OOM 的风险。

## 使用 bucket 增加并发

> **警告：**
>
> 当前该功能为实验特性，不建议在生产环境中使用。

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-版本开始引入) 来控制。
LykxSassinator marked this conversation as resolved.
Show resolved Hide resolved