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

pd: add new configurations #4478

Merged
merged 4 commits into from
Dec 24, 2020
Merged
Show file tree
Hide file tree
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
Next Next commit
update pd configurations
  • Loading branch information
CharLotteiu committed Dec 23, 2020
commit a7e75d6940e35ef257bda1ffa63abdd768af803e
13 changes: 12 additions & 1 deletion pd-configuration-file.md
Original file line number Diff line number Diff line change
Expand Up @@ -250,7 +250,7 @@ Configuration items related to scheduling

### `high-space-ratio`

+ The threshold ratio below which the capacity of the store is sufficient
+ The threshold ratio below which the capacity of the store is sufficient. This configuration only works when `region-score-formula-version` is set to `v1`.
+ Default value: `0.7`
+ Minimum value: greater than `0`
+ Maximum value: less than `1`
Expand All @@ -268,6 +268,17 @@ Configuration items related to scheduling
+ Default value: `0` (automatically adjusts the buffer size)
+ Minimum value: `0`

### `enable-cross-table-merge`

+ Determines whether to enable the merging of cross-table Regions
+ Default value: `true`

### `region-score-formula-version`

+ Controls the version of the Region score formula
+ Default value: `v2`
+ Optional values: `v1` and `v2`

### `disable-remove-down-replica`

+ Determines whether to disable the feature that automatically removes `DownReplica`. When this parameter is set to `true`, PD does not automatically clean up the copy in the down state.
Expand Down
13 changes: 11 additions & 2 deletions pd-control.md
Original file line number Diff line number Diff line change
Expand Up @@ -134,7 +134,7 @@ Usage:
"strictly-match-label": "false"
},
"schedule": {
"enable-cross-table-merge": "false",
"enable-cross-table-merge": "true",
"enable-debug-metrics": "false",
"enable-location-replacement": "true",
"enable-make-up-replica": "true",
Expand All @@ -156,6 +156,7 @@ Usage:
"merge-schedule-limit": 8,
"patrol-region-interval": "100ms",
"region-schedule-limit": 2048,
"region-score-formula-version": "v2",
"replica-schedule-limit": 64,
"scheduler-max-waiting-operator": 5,
"split-merge-interval": "1h0m0s",
Expand Down Expand Up @@ -227,6 +228,14 @@ Usage:
>> config set key-type raw // Enable cross table merge.
```

- `region-score-formula-version` controls the version of the Region score formula. The optional values are `v1` and `v2`. The version 2 of the formula helps to reduce redundant balance Region scheduling in some scenarios, such as taking TiKV nodes online or offline.

{{< copyable "" >}}

```bash
>> config set region-score-formula-version v2
```

- `patrol-region-interval` controls the execution frequency that `replicaChecker` checks the health status of Regions. A shorter interval indicates a higher execution frequency. Generally, you do not need to adjust it.

```bash
Expand Down Expand Up @@ -283,7 +292,7 @@ Usage:
config set low-space-ratio 0.9 // Set the threshold value of insufficient space to 0.9
```

- `high-space-ratio` controls the threshold value that is considered as sufficient store space. When the ratio of the space occupied by the node is less than the specified value, PD ignores the remaining space and mainly schedules the actual data volume.
- `high-space-ratio` controls the threshold value that is considered as sufficient store space. This configuration only works when `region-score-formula-version` is set to `v1`. When the ratio of the space occupied by the node is less than the specified value, PD ignores the remaining space and mainly schedules the actual data volume.

```bash
config set high-space-ratio 0.5 // Set the threshold value of sufficient space to 0.5
Expand Down