Skip to content

Commit 42cfc6e

Browse files
committed
add auto-detect
1 parent dc81418 commit 42cfc6e

File tree

1 file changed

+11
-4
lines changed

1 file changed

+11
-4
lines changed

online-unsafe-recovery.md

Lines changed: 11 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -7,9 +7,11 @@ summary: Learn how to use Online Unsafe Recovery.
77

88
> **Warning:**
99
>
10-
> Online Unsafe Recovery is a type of lossy recovery. If you use this feature, the integrity of data and data indexes cannot be guaranteed.
10+
> - Online Unsafe Recovery is a type of lossy recovery. If you use this feature, the integrity of data and data indexes cannot be guaranteed. If you encounter any issues, other tools or steps are required to recover your data.
11+
>
12+
> - Online Unsafe Recovery is introduced since TiDB v6.1.0. For versions earlier than v6.1.0, this is an experimental feature and the behavior is not the same as this document describes. It is **NOT** recommended to use this in versions earlier than v6.1.0. When you use this feature in a version other than v6.1, refer to the corresponding version of this document.
1113
12-
When permanently damaged replicas cause part of data on TiKV to be unreadable and unwritable, you can use the Online Unsafe Recovery feature to perform a lossy recovery operation.
14+
When permanently damaged replicas cause part of data on TiKV to be unreadable and unwritable, you can use the Online Unsafe Recovery feature to perform a lossy recovery operation and make TiKV continue providing services.
1315

1416
## Feature description
1517

@@ -56,6 +58,8 @@ If the command returns `Failed`, PD Control has failed to register the task to P
5658

5759
To specify the longest allowable duration of a recovery task, use the `--timeout <seconds>` option. If this option is not specified, the longest duration is 5 minutes by default. When the timeout occurs, the recovery is interrupted and returns an error.
5860

61+
If you cannot confirm the store IDs of failed stores, in the scenario where [`pd-recover`](/pd-recover.md) is executed to recover PD cluster, and the store information of unrecoverable TiKV nodes is lost, you can use the `--auto-detect` parameter to allow an empty store ID list. In this mode, all store IDs that are not in the PD store list is considered as unrecoverable and will be removed.
62+
5963
> **Note:**
6064
>
6165
> - Because this command needs to collect information from all peers, it might cause an increase in memory usage (100,000 peers are estimated to use 500 MiB of memory).
@@ -87,8 +91,11 @@ Each of the above stages is output in the JSON format, including information, ti
8791
```json
8892
[
8993
{
90-
"info": "Unsafe recovery enters collect report stage: failed stores 4, 5, 6",
91-
"time": "......"
94+
"info": "Unsafe recovery enters collect report stage",
95+
"time": "......",
96+
"details" : [
97+
"failed stores 4, 5, 6",
98+
]
9299
},
93100
{
94101
"info": "Unsafe recovery enters force leader stage",

0 commit comments

Comments
 (0)