
是一款分布式Key-Value数据库,其设计借鉴了Google Spanner和HBase,但实现更为简洁,无需依赖任何分布式文件系统。通过Rust语言实现Raft共识算法,并将共识状态存储于RocksDB中,TiKV保证数据一致性。引入Placement Driver(放置驱动)实现分片,支持数据自动迁移。事务模型参考Google Percolator并进行了性能优化,支持快照隔离(SI)、带锁快照隔离(SQL:SELECT ... FOR UPDATE)以及分布式事务中的外部一致性读写。
地理复制:TiKV使用http://raft.github.io/%E5%92%8Chttps://github.com/pingcap/pd/%E6%94%AF%E6%8C%81%E8%B7%A8%E5%9C%B0%E5%9F%9F%E6%95%B0%E6%8D%AE%E5%A4%8D%E5%88%B6%E3%80%82
水平扩展:借助Placement Driver和精心设计的Raft组,TiKV具备出色的水平扩展能力,可轻松扩展至100+ TB数据规模。
一致性分布式事务:类似Google Spanner,TiKV支持外部一致的分布式事务。
协处理器支持:参考HBase,TiKV实现了协处理器框架以支持分布式计算。
与TiDB协作:通过内部优化,TiKV与https://github.com/pingcap/tidb%E5%8D%8F%E5%90%8C%E5%B7%A5%E4%BD%9C%EF%BC%8C%E6%8F%90%E4%BE%9B%E5%85%BC%E5%85%B7%E9%AB%98%E6%B0%B4%E5%B9%B3%E6%89%A9%E5%B1%95%E8%83%BD%E5%8A%9B%E3%80%81%E5%A4%96%E9%83%A8%E4%B8%80%E8%87%B4%E4%BA%8B%E5%8A%A1%E5%8F%8A%E6%94%AF%E6%8C%81%E5%85%B3%E7%B3%BB%E5%9E%8B%E4%B8%8ENoSQL%E8%AE%BE%E8%AE%A1%E6%A8%A1%E5%BC%8F%E7%9A%84%E6%95%B0%E6%8D%AE%E5%BA%93%E8%A7%A3%E5%86%B3%E6%96%B9%E6%A1%88%E3%80%82
!TiKV软件栈
Placement Driver:集群管理器,定期检查复制约束以自动平衡负载和数据。
Store:每个Store包含一个RocksDB实例,负责将数据存储至本地磁盘。
Region:KV数据迁移的基本单元,每个Region会复制到多个节点,这些副本组成一个Raft组。
Node:集群中的物理节点,每个节点包含一个或多个Store,每个Store包含多个Region。
节点启动时,Node、Store和Region的元数据会注册到PD,各Region和Store的状态会定期上报至PD。
可通过https://github.com/pingcap/tidb-docker-compose/%E5%BF%AB%E9%80%9F%E6%B5%8B%E8%AF%95TiKV%E4%B8%8ETiDB%EF%BC%9A
bashgit clone https://github.com/pingcap/tidb-docker-compose/ cd tidb-docker-compose docker-compose up -d
启动后,可通过mysql -h 127.0.0.1 -P 4000 -u root连接数据库,并访问http://localhost:3000/查看集群监控指标。
TiKV代码库主要使用Rust编写,包含C++(RocksDB)和Go(gRPC)组件。为确保一致性,项目广泛使用代码检查和自动格式化工具,且依赖Rust nightly版本以使用最新特性。
前提条件
构建TiKV需至少安装以下工具:
git - 版本控制工具rustup - Rust工具链管理器awk - 模式扫描/处理语言cmake - 构建工具(gRPC依赖)go - 编程语言(gRPC依赖)make - 构建工具(运行常用工作流)clang 或 gcc - C编译器工具链获取代码库
bashgit clone https://github.com/pingcap/tikv.git cd tikv # 后续操作默认在此目录下执行
配置Rust工具链
rustup是Rust官方工具链管理器,类似Ruby的rvm或rbenv。TiKV使用RUST_VERSION文件指定的Rust版本,并依赖rustfmt组件:
bashrustup override set `tail -n 1 RUST_VERSION` rustup component add rustfmt-preview --toolchain `tail -n 1 RUST_VERSION`
构建与测试
TiKV提供
Makefile简化常用工作流,也可直接使用cargo操作Rust项目。
构建TiKV:
bashmake build
开发过程中,可使用cargo check快速检查代码(语法、借用检查、 lint)而不完整编译,配合cargo-watch可监听文件变化并自动执行检查:
bashcargo install cargo-watch cargo watch -s "cargo check --features dev"
提交PR前,建议运行dev任务进行代码格式化、启用clippy检查并执行测试:
bashmake dev
运行完整测试套件或指定测试:
bash# 完整测试 make test # 指定测试 cargo test $TESTNAME
所有PR会通过CI自动测试,合并前需确保CI测试通过。
集成其他组件
如需使用TiDB和PD等组件,建议参考https://github.com/pingcap/docs/blob/master/dev-guide/development.md%EF%BC%8C%E8%87%B3%E5%B0%91%E9%9C%80%E8%BF%90%E8%A1%8C%60pd-server%60%E4%B8%8E%60tikv-server%60%E8%BF%9B%E8%A1%8C%E9%9B%86%E6%88%90%E6%B5%8B%E8%AF%95%E3%80%82
Ansible部署:官方https://github.com/pingcap/docs/blob/master/op-guide/ansible-deployment.md%E6%8F%90%E4%BE%9B%E9%9B%86%E7%BE%A4%E9%83%A8%E7%BD%B2%E6%8E%A8%E8%8D%90%E6%96%B9%E6%A1%88%E3%80%82
Docker部署:参考https://github.com/pingcap/docs/blob/master/op-guide/docker-deployment.md%E9%83%A8%E7%BD%B2TiKV%E5%8F%8A%E5%85%B6%E4%BB%96%E9%9B%86%E7%BE%A4%E7%BB%84%E4%BB%B6%E3%80%82
二进制部署:如需自定义部署,可参考https://github.com/pingcap/docs/blob/master/op-guide/binary-deployment.md%E3%80%82
TiKV是TiDB项目的组件,需与PD(集群管理器)配合运行。目前支持的客户端包括https://github.com/pingcap/tidb/tree/master/store/tikv%E5%92%8Chttps://github.com/pingcap/tispark/tree/master/tikv-client/src/main/java/com/pingcap/tikv%E3%80%82%E6%AC%A2%E8%BF%8E%E5%BC%80%E5%8F%91%E5%85%B6%E4%BB%96%E8%AF%AD%E8%A8%80%E5%AE%A2%E6%88%B7%E7%AB%AF%E3%80%82
详见https://github.com/pingcap/docs/blob/master/op-guide/configuration.md%E4%BA%86%E8%A7%A3%E5%90%84%E7%B1%BB%E9%85%8D%E7%BD%AE%E9%80%89%E9%A1%B9%E3%80%82
提交补丁和贡献流程详见CONTRIBUTING。
TiKV基于Apache 2.0许可,详见LICENSE文件。
以下是 pingcap/rust 相关的常用 Docker 镜像,适用于 不同场景 等不同场景:
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录认证访问私有仓库
无需登录使用专属域名
Kubernetes 集群配置 Containerd
K3s 轻量级 Kubernetes 镜像加速
VS Code Dev Containers 配置
Podman 容器引擎配置
HPC 科学计算容器配置
ghcr、Quay、nvcr 等镜像仓库
Harbor Proxy Repository 对接专属域名
Portainer Registries 加速拉取
Nexus3 Docker Proxy 内网缓存
需要其他帮助?请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
docker search 限制
站内搜不到镜像
离线 save/load
插件要用 plugin install
WSL 拉取慢
安全与 digest
新手拉取配置
镜像合规机制
manifest unknown
no matching manifest(架构)
invalid tar header(解压)
TLS 证书失败
DNS 超时
域名连通性排查
410 Gone 排查
402 与流量用尽
401 认证失败
429 限流
D-Bus 凭证提示
413 与超大单层
来自真实用户的反馈,见证轩辕镜像的优质服务