pingcap / pingcap/docs

A bit of confusion terminolgoy about `TiKV` `TiKV store` `TiKV peer` `peer: replica of Region` in tidb-scheduling.md

Open
#5,929 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

area/engine tracked
Dominant language
Python
Stars
617
Forks
724
Avg merge
2d 10h
Merged PRs (30d)
223

Description

  1. When a new TiKV store is added, data can be rebalanced to it;
  2. The cluster can perform automatic disaster recovery from TiKV peers' failure.
  3. Note that here "position" is different from "machine". Generally PD can only ensure that replicas of a Region are not at a same peer to avoid that the peer's failure causes more than one replicas to become lost. However in production, you might have the following requirements:

Region is the minimal piece of data storage in TiKV, each representing a range of data (96 MiB by default). Each Region has three replicas by default. A replica of a Region is called a peer. Multiple peers of the same Region replicate data via the Raft consensus algorithm, so peers are also members of a Raft instance. TiKV uses Multi-Raft to manage data. That is, for each Region, there is a corresponding, isolated Raft group.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Open tidb-scheduling.md and review the uses of “TiKV,” “TiKV store,” “TiKV peer,” and “peer” in the reported passages. Clarify the terminology and the distinction between a peer, a replica, a store, and a machine; the issue is done when these terms are consistent and unambiguous.

Written by the indexing model from the issue text.

Assessment

Domain
databases, distributed-systems, documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
30/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.