TiKV

A distributed, transactional key-value store that gives systems like TiDB a horizontally scalable storage layer with strong consistency.

• Category: Storage & Database
• CNCF maturity: Graduated
• Language: Rust
• License: Apache-2.0
• Repository: tikv/tikv
• Documented at commit: 2ce1174 (2026-06-22)

What it is

TiKV is a distributed key-value store written in Rust. It started in 2016 at PingCAP as the storage layer for TiDB, and its design draws on Google's BigTable, Spanner, and Percolator papers plus the Raft consensus algorithm. Data is sharded into Regions, replicated by Raft, and persisted to RocksDB.

Above the raw key-value layer, TiKV implements distributed ACID transactions through Percolator-style two-phase commit. It exposes both a transactional API (TxnKV) and a raw API (RawKV), and it can be used directly through the client libraries or as the backend for TiDB's SQL engine. A separate component, the Placement Driver (tikv/pd), handles sharding, rebalancing, and timestamp allocation.

TiKV sits below SQL and above local disk. It owns consensus, MVCC, transaction scheduling, and storage, and it leaves query parsing and planning to layers above it such as TiDB.

When to use it

• You need a key-value store that scales past a single machine to 100+ TB while keeping strong consistency.
• You need distributed ACID transactions across keys, not just per-key atomicity.
• You are building on TiDB, or you want a transactional KV backend reachable through client-rust, client-go, client-java, or client-python.
• It is a poor fit for small configuration data where a single-node or small-cluster store like etcd is enough.
• It is a poor fit when you want SQL out of the box. TiKV is the KV layer, and SQL lives in TiDB.

In this deep-dive

• History: origin, milestones, and why it exists.
• Architecture: components and how requests flow.
• Adoption & Ecosystem: who runs it and what surrounds it.
• Internals: the code paths that matter, read from source.
• Getting Started: install and a first working setup.

Sources

1. Cloud Native Computing Foundation announces TiKV Graduation (CNCF)
2. Celebrating TiKV's CNCF Graduation (TiKV blog)
3. TiKV project page (CNCF)
4. tikv/tikv README
5. TOC votes to move TiKV into CNCF Incubator (CNCF)
6. CNCF TOC votes to move TiKV to Incubating Status (TiKV blog)
7. TiKV Adopters
8. Case study: TiKV in JD Cloud (CNCF)
9. tikv/tikv GitHub stats
10. TiKV Documentation
11. TiKV Governance (tikv/community)