https://github.com/pingcap/tidb Skip to content Navigation Menu Toggle navigation Sign in * Product + GitHub Copilot Write better code with AI + Security Find and fix vulnerabilities + Actions Automate any workflow + Codespaces Instant dev environments + Issues Plan and track work + Code Review Manage code changes + Discussions Collaborate outside of code + Code Search Find more, search less Explore + All features + Documentation + GitHub Skills + Blog * Solutions By company size + Enterprises + Small and medium teams + Startups By use case + DevSecOps + DevOps + CI/CD + View all use cases By industry + Healthcare + Financial services + Manufacturing + Government + View all industries View all solutions * Resources Topics + AI + DevOps + Security + Software Development + View all Explore + Learning Pathways + White papers, Ebooks, Webinars + Customer Stories + Partners + Executive Insights * Open Source + GitHub Sponsors Fund open source developers + The ReadME Project GitHub community articles Repositories + Topics + Trending + Collections * Enterprise + Enterprise platform AI-powered developer platform Available add-ons + Advanced Security Enterprise-grade security features + GitHub Copilot Enterprise-grade AI features + Premium Support Enterprise-grade 24/7 support * Pricing Search or jump to... Search code, repositories, users, issues, pull requests... Search [ ] Clear Search syntax tips Provide feedback We read every piece of feedback, and take your input very seriously. [ ] [ ] Include my email address so I can be contacted Cancel Submit feedback Saved searches Use saved searches to filter your results more quickly Name [ ] Query [ ] To see all available qualifiers, see our documentation. Cancel Create saved search Sign in Sign up Reseting focus You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session. Dismiss alert {{ message }} pingcap / tidb Public * Notifications You must be signed in to change notification settings * Fork 5.9k * Star 37.6k TiDB - the open-source, cloud-native, distributed SQL database designed for modern applications. pingcap.com License Apache-2.0 license 37.6k stars 5.9k forks Branches Tags Activity Star Notifications You must be signed in to change notification settings * Code * Issues 3.6k * Pull requests 1.2k * Discussions * Actions * Projects 3 * Wiki * Security * Insights Additional navigation options * Code * Issues * Pull requests * Discussions * Actions * Projects * Wiki * Security * Insights pingcap/tidb master BranchesTags [ ] Go to file Code Folders and files Last commit Last Name Name message commit date Latest commit History 25,408 Commits .github .github LICENSES LICENSES br br build build cmd cmd docs docs dumpling dumpling hooks hooks lightning lightning pkg pkg tests tests tools tools .bazelrc .bazelrc .bazelversion .bazelversion .codecov.yml .codecov.yml .dockerignore .dockerignore .editorconfig .editorconfig .gitattributes .gitattributes .gitignore .gitignore .gitmodules .gitmodules .golangci.yml .golangci.yml .pre-commit-config.yaml .pre-commit-config.yaml BUILD.bazel BUILD.bazel CODE_OF_CONDUCT.md CODE_OF_CONDUCT.md CONTRIBUTING.md CONTRIBUTING.md CONTRIBUTORS.md CONTRIBUTORS.md DEPS.bzl DEPS.bzl Dockerfile Dockerfile Dockerfile.enterprise Dockerfile.enterprise Jenkinsfile Jenkinsfile LICENSE LICENSE MODULE.bazel MODULE.bazel Makefile Makefile Makefile.common Makefile.common OWNERS OWNERS OWNERS_ALIASES OWNERS_ALIASES README.md README.md SECURITY.md SECURITY.md WORKSPACE WORKSPACE WORKSPACE.patchgo WORKSPACE.patchgo checklist.md checklist.md ci.md ci.md code_review_guide.md code_review_guide.md errors.toml errors.toml go.mod go.mod go.sum go.sum roadmap.md roadmap.md View all files Repository files navigation * README * Code of conduct * Apache-2.0 license * Security TiDB, a distributed SQL database --------------------------------------------------------------------- License Language Build Status Go Report Card GitHub release TiDB TiDB (/'taIdi: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 Tip As part of our commitment to open source, we want to reward all GitHub users. In addition to the free tier, you can get up to $2000 in TiDB Cloud Serverless credits for your open-source contributions - Claim here. 1. Start a TiDB Cluser + On Local Playground. To start a local test cluster, please refer to the TiDB quick start guide. + On Kubernetes. TiDB can be easily deployed in a self-managed Kubernetes environment or Kubernetes services on public clouds using TiDB Operator. For more details, please refer to the TiDB on Kubernetes quick start guide. + Using TiDB Cloud (Recommended). TiDB Cloud offers a fully managed version of TiDB with a free tier, no credit card required, so you can get a free cluster in seconds and start easily: Sign up for TiDB Cloud. 2. Learn About TiDB SQL: To explore the SQL capabilities of TiDB, refer to the TiDB SQL documentation. 3. Use MySQL Driver or ORM to Build an App with TiDB with TiDB. 4. Explore key features, such as data migration, changefeed, vector search, HTAP, disaster recovery, etc. Need Help? * You can connect with TiDB users, ask questions, find answers, and help others on our community platforms: Discord, Slack (English, Japanese), Stack Overflow, TiDB Forum (English, Chinese), X @PingCAP * For filing bugs, suggesting improvements, or requesting new features, use Github Issues or join discussions on Github Discussions. * To troubleshoot TiDB, refer to Toubleshooting documentation. Architecture TiDB architecture Learn more details about TiDB architecture in our Docs. Contributing TiDB is built on a commitment to open source, and we welcome contributions from everyone. Whether you are interested in improving documentation, fixing bugs, or developing new features, we invite you to shape the future of TiDB. * See our Contributor Guide and TiDB Development Guide to get started. * If you're looking for issues to work on, try looking at the good first issues or help wanted issues. * The contribution map lists everything you can contribute. * The community repository contains everything else you need. * Don't forget to claim your contribution swag by filling in and submitting this form. Active Contributors of pingcap/tidb - Last 28 days License TiDB is under the Apache 2.0 license. See the LICENSE file for details. See Also * TiDB Online Playgroud * TiDB Case Studies: TiDB Customers, TiDB Shi Li Ji Shi , TiDB Zhong Wen Yong Hu An Li * TiDB User Documentation * TiDB Design Docs * TiDB Release Notes * TiDB Blog * TiDB Roadmap Acknowledgments * Thanks cznic for providing some great open source tools. * Thanks GolevelDB, BoltDB, and RocksDB for their powerful storage engines. About TiDB - the open-source, cloud-native, distributed SQL database designed for modern applications. pingcap.com Topics mysql go sql database scale serverless distributed-transactions distributed-database cloud-native tidb hacktoberfest htap mysql-compatibility Resources Readme License Apache-2.0 license Code of conduct Code of conduct Security policy Security policy Activity Custom properties Stars 37.6k stars Watchers 1.3k watching Forks 5.9k forks Report repository Releases 204 TiDB v7.5.5 Latest Dec 31, 2024 + 203 releases Packages 0 No packages published Used by 1k * @fllm2 * @Cookie-27 * @lb234111 * @WangYifan321 * @7774596 * @sdsasf * @chaixuqing * @chaixuqing + 996 Contributors 886 * * * * * * * * * * * * * * + 872 contributors Languages * Go 94.3% * Starlark 3.1% * Shell 1.4% * Yacc 0.9% * Jsonnet 0.1% * TypeScript 0.1% * Other 0.1% Footer (c) 2025 GitHub, Inc. Footer navigation * Terms * Privacy * Security * Status * Docs * Contact * Manage cookies * Do not share my personal information You can't perform that action at this time.