pingcap /tidb
TiDB is built for agentic workloads that grow unpredictably, with ACID guarantees and native support for transactions, analytics, and vector search. No data silos. No noisy neighbors. No infrastructure ceiling.
★ 40,725⑂ 6,291👁 1,205⑃ 47,762● 24,720▤ 217◈ 156
40,725
stars
+4
6,291
forks
1,205
watchers
47,762
prs
24,720
issues
217
releases
156
discussions
README
---
TiDB
TiDB (/’taɪdiːbi:/, "Ti" stands for Titanium) is an open-source, cloud-native, distributed SQL database designed for high availability, horizontal and vertical scalability, strong consistency, and high performance.
- Key Features
- Quick Start
- Need Help?
- Architecture
- Contributing
- License
- See Also
- Acknowledgments
Key Features
- Distributed Transactions: TiDB uses a two-phase commit protocol to ensure ACID compliance, providing strong consistency. Transactions span multiple nodes, and TiDB's distributed nature ensures data correctness even in the presence of network partitions or node failures.
- Horizontal and Vertical Scalability: TiDB can be scaled horizontally by adding more nodes or vertically by increasing resources of existing nodes, all without downtime. TiDB's architecture separates computing from storage, enabling you to adjust both independently as needed for flexibility and growth.
- High Availability: Built-in Raft consensus protocol ensures reliability and automated failover. Data is stored in multiple replicas, and transactions are committed only after writing to the majority of replicas, guaranteeing strong consistency and availability, even if some replicas fail. Geographic placement of replicas can be configured for different disaster tolerance levels.
- Hybrid Transactional/Analytical Processing (HTAP): TiDB provides two storage engines: TiKV, a row-based storage engine, and TiFlash, a columnar storage engine. TiFlash uses the Multi-Raft Learner protocol to replicate data from TiKV in real time, ensuring consistent data between the TiKV row-based storage engine and the TiFlash columnar storage engine. The TiDB Server coordinates query execution across both TiKV and TiFlash to optimize performance.
- Cloud-Native: TiDB can be deployed in public clouds, on-premises, or natively in Kubernetes. TiDB Operator helps manage TiDB on Kubernetes, automating cluster operations, while TiDB Cloud provides a fully-managed service for easy and economical deployment, allowing users to set up clusters with just a few clicks.
- MySQL Compatibility: TiDB is compatible with MySQL 8.0, allowing you to use familiar protocols, frameworks and tools. You can migrate applications to TiDB without changing any code, or with minimal modifications. Additionally, TiDB provides a suite of data migration tools to help easily migrate application data into TiDB.
- Open Source Commitment: Open source is at the core of TiDB's identity. All source code is available on GitHub under the Apache 2.0 license, including enterprise-grade features. TiDB is built with the belief that open source enables transparency, innovation, and collaboration. We actively encourage contributions from the community to help build a vibrant and inclusive ecosystem, reaffirming our commitment to open development and accessibility for everyone.
Quick Start
1. Start a TiDB cluster.
- On local playground. To start a local test cluster, refer to tTop issues
#66977Flaky test: TestResourceGroupRunaway in pkg/resourcegroup/tests116 comments · 2026-03-13#67401Flaky test: TestGlobalMemoryControlForAnalyze in pkg/executor/test/analyzetest/memorycontrol73 comments · 2026-03-30#67566Flaky test: TestResourceGroupRunawayFlood in pkg/resourcegroup/tests61 comments · 2026-04-04#68304Flaky test: TestMemoryUsageAndOpsHistory in pkg/infoschema/test/clustertablestest57 comments · 2026-05-12#69696Flaky test: TestPlanStatsLoad/off in pkg/planner/core/casetest/planstats42 comments · 2026-07-07#66373Flaky test: TestKillAutoAnalyze in pkg/executor/test/analyzetest37 comments · 2026-02-25#67700Flaky test: TestGlobalMemoryControlForAutoAnalyze in pkg/executor/test/analyzetest/memorycontrol33 comments · 2026-04-11#68143Flaky test: TestPrepareCacheChangingParamType in pkg/planner/core/tests/prepare31 comments · 2026-04-30
Discussions
#72476TiDB Monthly Product Update — October 20260 comments · 2026-10-28#72051Announcing upgrade to Go 1.271 comments · 2026-10-16#71711TiDB Monthly Product Update — September 20260 comments · 2026-09-30#70781TiDB Monthly Product Update — August 20260 comments · 2026-09-01#70727TiDB into Apache Arrow through ADBC, using MySQL Connector/ODBC 9.4 (adbcBridge 0.1.0)2 comments · 2026-08-28#69603Is there any advice on dual password implementation?1 comments · 2026-07-02#68062Embed Agent Friendly Code Score Badge0 comments · 2026-04-27#67172Rebuild project automatically0 comments · 2026-03-20
Latest release
TiDB v7.5.8 v7.5.8 2026-09-17For new features, improvements, and bug fixes released in v7.5.8 for TiDB, see TiDB v7.5.8 release notes. See the difference from the issue perspective: - pingcap/tidb62608 - pingcap/tidb63235 - pingcap/tidb64274 - pingcap/tidb58400 - pingcap/tidb66391 - pingcap/tidb70419