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.

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

docs: update pd-configuration about upgrade #6510

Merged
merged 2 commits into from
Sep 29, 2021
Merged
Changes from 1 commit
Commits
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: 10 additions & 2 deletions pd-configuration-file.md
Original file line number Diff line number Diff line change
Expand Up @@ -268,11 +268,15 @@ Configuration items related to scheduling
+ Determines whether to enable the merging of cross-table Regions
+ Default value: `true`

### `region-score-formula-version`
### `region-score-formula-version` <span class="version-mark">New in v5.0</span>

+ Controls the version of the Region score formula
+ Default value: `v2`
+ Optional values: `v1` and `v2`
+ Optional values: `v1` and `v2`. Compared to v1, the changes in v2 are smoother, and the scheduling jitter caused by space recovery is improved.
TomShawn marked this conversation as resolved.
Show resolved Hide resolved

> **Note:**
>
> If you upgrade from TiDB 4.0 versions to the current versions, the new formula version is automatically disabled by default to ensure consistent PD behavior before and after upgrading. If you want to change the formula version, you need to manually switch through the `pd-ctl` setting. For details, refer to [PD Control](/pd-control.md#config-show--set-option-value--placement-rules).
TomShawn marked this conversation as resolved.
Show resolved Hide resolved

### `enable-joint-consensus` <span class="version-mark">New in v5.0</span>

Expand Down Expand Up @@ -317,6 +321,10 @@ Configuration items related to replicas
+ Default value: 3
+ PD rounds the lowest digits of the flow number, which reduces the update of statistics caused by the changes of the Region flow information. This configuration item is used to specify the number of lowest digits to round for the Region flow information. For example, the flow `100512` will be rounded to `101000` because the default value is `3`. This configuration replaces `trace-region-flow`.

> **Note:**
>
> If you upgrade from TiDB 4.0 versions to the current versions, the behavior of `flow-round-by-digit` after the upgrading and the behavior of `trace-region-flow` before upgrading are consistent by default. This means that if the value of `trace-region-flow` is false before upgrading, then the value of `flow-round-by-digit` after upgrading is 127;if the value of `trace-region-flow` is true before upgrading, then the value of `flow-round-by-digit` after upgrading is 3.
TomShawn marked this conversation as resolved.
Show resolved Hide resolved

## `label-property`

Configuration items related to labels
Expand Down