# 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.

Repository: https://github.com/pingcap/tidb
Canonical: https://ross.abutalabs.com/products/tidb
Homepage: https://www.tidb.io/
Language: Go
License: Apache-2.0
License Family: permissive
Topics: distributed-database, distributed-transactions, tidb, database, scale, mysql, htap, sql, cloud-native, serverless, mysql-compatibility, go, hacktoberfest, agent, agent-context, agent-memory, agentic, ai, memory
Last push: 2026-08-27T00:38:00+00:00
Link (homepage): https://www.tidb.io/
Link (site_page): https://www.pingcap.com/pricing
Link (site_page): https://www.pingcap.com/integrations
Link (site_page): https://www.pingcap.com/press-releases-news
Link (site_page): https://www.pingcap.com/about-us

## Health v2 (maintenance only)
Score: 99/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 99, longevity 100
- inputs: {"age_days": 4014, "days_push": 7, "days_rel": 6, "gap_med": 26.5, "n_releases_24m": 19}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 40473, forks 6234 (observed 2026-08-28T04:12:08.234301+00:00)

## What it is
TiDB is an open-source, cloud-native distributed SQL database written in Go, MySQL-compatible and designed for horizontal scalability, strong consistency, and high availability via Raft consensus. It supports HTAP workloads by combining row-based TiKV with columnar TiFlash storage, and now offers native vector search for AI agent workloads, with both self-managed and fully-managed cloud offerings.

## Use cases
- scale a MySQL-compatible database horizontally without sharding
- run transactional and analytical queries on one database (HTAP)
- store and search vector embeddings for AI agent memory and context
- replace hundreds of sharded PostgreSQL or MySQL clusters
- build globally available, highly consistent backend storage for SaaS
- deploy a database on Kubernetes with automated operations
- migrate from MySQL + object storage to a unified database

## When to choose
- you need MySQL compatibility with horizontal scale-out and no manual sharding
- you want ACID distributed transactions with strong consistency and automatic failover
- your workload mixes OLTP and OLAP and you want one unified database
- you are building agentic AI applications needing transactions plus vector search
- you need to scale to very large table counts and concurrent connections

## When to avoid
- you need a small, single-node embedded database with minimal operational footprint
- your workload is purely analytical with no transactional requirements (a columnar warehouse may fit better)
- you depend on MySQL features TiDB does not support (triggers, some stored procedures, foreign keys in older versions)
- you want a lightweight key-value store rather than a full SQL database
- your team cannot operate a multi-component distributed cluster and you cannot use the managed cloud

## Facets
- artifact type: service
- maturity: stable
- function: database, vector-database, search-engine, caching
- domain: databases, microservices, large-language-models, cloud-computing, analytics
- platform: cloud, self-hosted, go
- tags: distributed-sql, htap, mysql-compatible, raft, horizontal-scaling, acid-transactions, tiflash, tikv, dbaas, agentic-workloads, vector-search, mysql-protocol, ai-agents, linux, macos, kubernetes, docker

## Member repositories
- pingcap/tidb (main) score 99
- pingcap/docs-cn (docs) score 76
- pingcap/parser (mirror) score 23
- pingcap/tidb-operator (infra) score 94
- pingcap/tiflash (backend) score 100

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:12:08.234301+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T16:24:04.122913+00:00, confidence not recorded.
  - readme: https://github.com/pingcap/tidb (fetched 2026-08-28T04:12:08.234301+00:00, sha 18dc3a29dd45)
  - homepage: https://www.tidb.io/ (fetched 2026-08-29T07:46:52.182881+00:00, sha bc5f1edb876f)
  - site_page: https://www.pingcap.com/about-us (fetched 2026-08-29T07:46:52.199888+00:00, sha a9c82ce741d7)
  - site_page: https://docs.pingcap.com/ (fetched 2026-08-29T07:46:52.201720+00:00, sha dcfbe4328796)
  - site_page: https://docs.pingcap.com (fetched 2026-08-29T07:46:52.203401+00:00, sha dcfbe4328796)
  - site_page: https://docs.pingcap.com/tidb/stable/faq-overview (fetched 2026-08-29T07:46:52.205110+00:00, sha 303b1e1e7087)
  - site_page: https://www.pingcap.com/pricing (fetched 2026-08-29T07:46:52.192329+00:00, sha f46024df64f3)
  - site_page: https://www.pingcap.com/integrations (fetched 2026-08-29T07:46:52.195145+00:00, sha 4b5ecd2cd833)
  - site_page: https://www.pingcap.com/press-releases-news (fetched 2026-08-29T07:46:52.197870+00:00, sha 7b06174a9992)
- Data as of 2026-08-30T08:39:29.467469+00:00.