TiDB单机测试配置文档

第一种：使用TiUP Playground 快速部署本地测试环境

• 适用场景：利用本地Mac 或者单机Linux 环境快速部署TiDB 集群。可以体验TiDB 集群的基本架构，以及

TiDB、TiKV、PD、监控等基础组件的运行。

作为一个分布式系统，最基础的TiDB 测试集群通常由2 个TiDB 实例、3 个TiKV 实例和3 个PD 实例来构成。通

过TiUP Playground，可以快速搭建出上述的一套基础测试集群。

1. 下载并安装TiUP。

curl –proto ‘=https’ –tlsv1.2 -sSf https://tiup-mirrors.pingcap.com/install.sh | sh

1. 声明全局环境变量。

注意：

TiUP 安装完成会提示对应的profile 文件的绝对路径，以下source 操作需要根据实际位置进

行操作。

source .bash_profile

1. 在当前session 执行以下命令启动集群。

• 直接运行tiup playground 命令会运行最新版本的TiDB 集群，其中TiDB、TiKV 和PD 实例各1 个：

tiup playground  –host 192.168.15.4

• 也可以指定TiDB 版本以及各组件实例个数，命令类似于：

tiup playground v4.0.0 –db 2 –pd 3 –kv 3 –monitor

上述命令会在本地下载并启动一个v4.0.0 版本的集群，–monitor 表示同时部署监控组件。最新

版本可以通过执行tiup list tidb 来查看。运行结果将显示集群的访问方式：

CLUSTER START SUCCESSFULLY, Enjoy it ^-^

To connect TiDB: mysql –host 192.168.15.4 –port 4000 -u root

To view the dashboard: http://192.168.15.4:13799/dashboard

To view the Prometheus: http://192.168.15.4:9090

To view the Grafana: http://192.168.15.4:30004. 新开启一个session 以访问TiDB 数据库。

1. 首先安装MySQL 客户端。如果已安装MySQL 客户端则可跳过这一步骤。

yum -y install mysql

1. 使用MySQL 客户端连接TiDB：

mysql –host 127.0.0.1 –port 4000 -u root

1. 通过http://127.0.0.1:9090 访问TiDB 的Prometheus 管理界面。
2. 通过http://127.0.0.1:2379/dashboard 访问TiDB Dashboard 页面，默认用户名为root，密码为空。
3. 测试完成后清理集群，绿色环保。通过ctrl-c 停掉进程后，执行以下命令：

tiup clean –all

注意：

TiUP Playground 默认监听127.0.0.1，服务仅本地可访问；若需要使服务可被外部访问，你可

以通过–host 参数指定监听0.0.0.0 或网卡绑定外部可访问的IP。