ckeyer/tidb

TiDB 镜像文档

概述

TiDB 是一款分布式 SQL 数据库，灵感来源于 Google F1 的设计理念，融合了传统关系型数据库（RDBMS）和 NoSQL 的最佳特性。它旨在提供水平可扩展性、高可用性以及强大的数据一致性，同时保持与 MySQL 协议的兼容性，使应用迁移更加平滑。

核心功能与特性

• 水平扩展能力
  随着业务增长，可通过简单添加机器实现 TiDB 容量扩展，无需复杂的架构调整。

• 异步 Schema 变更
  支持在不中断或影响正在进行的业务操作的情况下，动态添加新列和索引，适应业务需求的持续演进。

• 一致性分布式事务
  支持跨多台机器的事务操作，确保数据一致性，使应用代码如同操作单机数据库般简单可靠。

• MySQL 协议兼容
  兼容 MySQL 协议，大多数场景下可直接替换 MySQL 作为数据库后端，无需修改应用代码。

• Go 语言开发
  采用 Go 语言编写，代码易于维护和扩展，便于快速迭代优化，降低二次开发门槛。

• 基于 TiKV 的 NewSQL 能力
  将分布式键值存储 TiKV 转换为功能完备的 NewSQL 数据库，结合分布式存储与 SQL 能力。

• 多存储引擎支持
  单机模式下支持多种流行存储引擎，包括 GolevelDB、LevelDB、RocksDB、LMDB、BoltDB 等，可根据需求灵活选择。

适用场景与范围

• 高并发业务场景：需要应对大规模用户访问和数据写入的互联网应用。
• 数据量增长迅速的业务：需随数据量增长平滑扩展存储和计算能力的场景。
• 在线业务系统：需支持不间断 Schema 变更，避免业务中断的核心业务系统。
• 分布式事务需求：需要跨节点事务保证数据一致性的分布式应用。
• MySQL 迁移场景：希望从 MySQL 平滑迁移，减少应用改造成本的企业。

使用方法与配置说明

快速启动

详细部署步骤请参考官方 https://github.com/pingcap/tidb/blob/master/docs/QUICKSTART.md%E3%80%82

Docker 部署示例

单节点快速体验

bash
docker run -d --name tidb -p 4000:4000 pingcap/tidb:latest

启动后，可通过 MySQL 客户端连接：

bash
mysql -h 127.0.0.1 -P 4000 -u root

分布式集群部署（docker-compose）

创建 docker-compose.yml 文件：

yaml
version: '3'
services:
  pd:
    image: pingcap/pd:latest
    ports:
      - "2379:2379"
    volumes:
      - ./pd/data:/data
    command: --name=pd1 --data-dir=/data --client-urls=http://0.0.0.0:2379 --peer-urls=http://0.0.0.0:2380 --initial-cluster=pd1=http://pd:2380

  tikv:
    image: pingcap/tikv:latest
    volumes:
      - ./tikv/data:/data
    command: --pd=pd:2379 --data-dir=/data --addr=0.0.0.0:20160

  tidb:
    image: pingcap/tidb:latest
    ports:
      - "4000:4000"
    command: --store=tikv --path=pd:2379

启动集群：

bash
docker-compose up -d

核心配置参数

TiDB 支持通过命令行参数或配置文件进行配置，常用参数包括：

详细配置说明请参考 官方配置文档。

架构

TiDB 架构由三大核心组件构成：

• TiDB 服务器：负责 SQL 解析、优化和执行，提供 MySQL 协议接口。
• TiKV：分布式键值存储引擎，负责数据的持久化存储和分布式事务。
• PD（Placement Driver）：集群管理组件，负责元数据管理、负载均衡和调度。

架构图可参考 https://github.com/pingcap/tidb/blob/master/docs/architecture.png%E3%80%82

贡献与社区

欢迎通过 https://github.com/pingcap/tidb 贡献代码，详情请参考 https://github.com/pingcap/tidb/blob/master/CONTRIBUTING.md%E3%80%82

许可证

TiDB 采用 Apache 2.0 许可证，详见 https://github.com/pingcap/tidb/blob/master/LICENSES/LICENSE%E3%80%82