TiDB 数据库快速上手指南

TiDB 是一个分布式系统。最基础的 TiDB 测试集群通常由 2 个 TiDB 实例、3 个 TiKV 实例、3 个 PD 实例和可选的 TiFlash 实例构成。通过 TiUP Playground，可以快速搭建出上述的一套基础测试集群，步骤如下：

下载并安装 TiUP。
声明全局环境变量。

注意：

TiUP 安装完成后会提示对应文件的绝对路径。在执行以下 source 命令前，需要根据 profile 文件的实际位置修改命令。
```
 source .bash_profile
```
在当前 session 执行以下命令启动集群。
- 直接执行 tiup playground 命令会运行最新版本的 TiDB 集群，其中 TiDB、TiKV、PD 和 TiFlash 实例各 1 个：
```
  tiup playground
```
- 也可以指定 TiDB 版本以及各组件实例个数，命令类似于：
```
  tiup playground v5.2.0 --db 2 --pd 3 --kv 3 --monitor
```
  上述命令会在本地下载并启动某个版本的集群（例如 v5.2.0），--monitor 表示同时部署监控组件。最新版本可以通过执行 tiup list tidb 来查看。运行结果将显示集群的访问方式：
```
  CLUSTER START SUCCESSFULLY, Enjoy it ^-^
  To connect TiDB: mysql --host 127.0.0.1 --port 4000 -u root
  To connect TiDB: mysql --host 127.0.0.1 --port 4001 -u root
  To view the dashboard: http://127.0.0.1:2379/dashboard
  To view the monitor: http://127.0.0.1:9090
```
  注意：
  - 支持 v5.2.0 及以上版本的 TiDB 在 Apple M1 芯片的机器上运行 tiup playground。
  - 以这种方式执行的 playground，在结束部署测试后 TiUP 会清理掉原集群数据，重新执行该命令后会得到一个全新的集群。
  - 若希望持久化数据，可以执行 TiUP 的 --tag 参数：tiup --tag <your-tag> playground ...，详情参考 TiUP 参考手册。
新开启一个 session 以访问 TiDB 数据库。
- 使用 TiUP client 连接 TiDB：
```
  tiup client
```
- 也可使用 MySQL 客户端连接 TiDB：
```
  mysql --host 127.0.0.1 --port 4000 -u root
```
通过访问 TiDB 的 Prometheus 管理界面。
通过 http://127.0.0.1:2379/dashboard 访问页面，默认用户名为 root，密码为空。
（可选）将数据加载到 TiFlash 进行分析。
测试完成之后，可以通过执行以下步骤来清理集群：
1. 通过按下 ctrl + c 键停掉进程。
2. 执行以下命令：
```
 tiup clean --all
```

TiDB 是一个分布式系统。最基础的 TiDB 测试集群通常由 2 个 TiDB 实例、3 个 TiKV 实例、3 个 PD 实例和可选的 TiFlash 实例构成。通过 TiUP Playground，可以快速搭建出上述的一套基础测试集群。

下载并安装 TiUP。

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

注意：

TiUP 安装完成后会提示对应 profile 文件的绝对路径。在执行以下 source 命令前，需要根据 profile 文件的实际位置修改命令。
在当前 session 执行以下命令启动集群。
- 直接运行 tiup playground 命令会运行最新版本的 TiDB 集群，其中 TiDB、TiKV、PD 和 TiFlash 实例各 1 个：
```
  tiup playground
```
- 也可以指定 TiDB 版本以及各组件实例个数，命令类似于：
```
  tiup playground v5.2.0 --db 2 --pd 3 --kv 3 --monitor
```
  上述命令会在本地下载并启动某个版本的集群（例如 v5.2.0），--monitor 表示同时部署监控组件。最新版本可以通过执行 tiup list tidb 来查看。运行结果将显示集群的访问方式：
```
  CLUSTER START SUCCESSFULLY, Enjoy it ^-^
  To connect TiDB: mysql --host 127.0.0.1 --port 4000 -u root -p (no password) --comments
  To view the dashboard: http://127.0.0.1:2379/dashboard
  PD client endpoints: [127.0.0.1:2379]
  To view the Prometheus: http://127.0.0.1:9090
  To view the Grafana: http://127.0.0.1:3000
```
  注意：
  - 以这种方式执行的 playground，在结束部署测试后 TiUP 会清理掉原集群数据，重新执行该命令后会得到一个全新的集群。
  - 若希望持久化数据，可以执行 TiUP 的 --tag 参数：tiup --tag <your-tag> playground ...，详情参考。
新开启一个 session 以访问 TiDB 数据库。
- 使用 TiUP client 连接 TiDB：
- 也可使用 MySQL 客户端连接 TiDB：
通过 http://127.0.0.1:9090 访问 TiDB 的 Prometheus 管理界面。
通过访问 TiDB Dashboard 页面，默认用户名为 root，密码为空。
通过访问 TiDB 的 Grafana 界面，默认用户名和密码都为 admin。
（可选）将数据加载到 TiFlash 进行分析。
测试完成之后，可以通过执行以下步骤来清理集群：
1. 通过按下 ctrl + c 键停掉进程。
2. 执行以下命令：
```
tiup clean --all
```

适用场景：希望用单台 Linux 服务器，体验 TiDB 最小的完整拓扑的集群，并模拟生产的部署步骤。
耗时：10 分钟

本节介绍如何参照 TiUP 最小拓扑的一个 YAML 文件部署 TiDB 集群。

准备一台部署主机，确保其软件满足需求：

推荐安装 CentOS 7.3 及以上版本
Linux 操作系统开放外网访问，用于下载 TiDB 及相关软件安装包

最小规模的 TiDB 集群拓扑：

注意：

下表中拓扑实例的 IP 为示例 IP。在实际部署时，请替换为实际的 IP。

部署主机软件和环境要求：

部署需要使用部署主机的 root 用户及密码
部署主机或者开放 TiDB 集群的节点间所需端口
目前 TiUP 支持在 x86_64（AMD64 和 ARM）架构上部署 TiDB 集群
- 在 AMD64 架构下，建议使用 CentOS 7.3 及以上版本 Linux 操作系统
- 在 ARM 架构下，建议使用 CentOS 7.6 1810 版本 Linux 操作系统

实施部署

注意：

下载并安装 TiUP：

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

安装 TiUP 的 cluster 组件：
```
 tiup cluster
```
如果机器已经安装 TiUP cluster，需要更新软件版本：
由于模拟多机部署，需要通过 root 用户调大 sshd 服务的连接数限制：
1. 修改 /etc/ssh/sshd_config 将 MaxSessions 调至 20。
2. 重启 sshd 服务：
```
 service sshd restart
```

创建并启动集群

按下面的配置模板，编辑配置文件，命名为 topo.yaml，其中：

user: "tidb"：表示通过 tidb 系统用户（部署会自动创建）来做集群的内部管理，默认使用 22 端口通过 ssh 登录目标机器
replication.enable-placement-rules：设置这个 PD 参数来确保 TiFlash 正常运行

host：设置为本部署主机的 IP

配置模板如下：

# # Global variables are applied to all deployments and used as the default value of
# # the deployments if a specific deployment value is missing.
global:
user: "tidb"
ssh_port: 22
deploy_dir: "/tidb-deploy"
data_dir: "/tidb-data"
# # Monitored variables are applied to all the machines.
monitored:
node_exporter_port: 9100
blackbox_exporter_port: 9115
server_configs:
tidb:
 log.slow-threshold: 300
tikv:
 readpool.storage.use-unified-pool: false
 readpool.coprocessor.use-unified-pool: true
pd:
 replication.enable-placement-rules: true
 replication.location-labels: ["host"]
tiflash:
 logger.level: "info"
pd_servers:
tidb_servers:
- host: 10.0.1.1
tikv_servers:
- host: 10.0.1.1
 port: 20160
 status_port: 20180
 config:
   server.labels: { host: "logic-host-1" }
- host: 10.0.1.1
 port: 20161
 status_port: 20181
 config:
   server.labels: { host: "logic-host-2" }
- host: 10.0.1.1
 port: 20162
 status_port: 20182
 config:
   server.labels: { host: "logic-host-3" }
tiflash_servers:
- host: 10.0.1.1
monitoring_servers:
- host: 10.0.1.1
grafana_servers:
- host: 10.0.1.1

执行集群部署命令：
```
 tiup cluster deploy <cluster-name> <tidb-version> ./topo.yaml --user root -p
```
- 参数 <cluster-name> 表示设置集群名称
- 参数 <tidb-version> 表示设置集群版本，可以通过 tiup list tidb 命令来查看当前支持部署的 TiDB 版本
  
  按照引导，输入”y”及 root 密码，来完成部署：
```
Do you want to continue? [y/N]:  y
Input SSH password:
```
启动集群：
```
 tiup cluster start <cluster-name>
```
访问集群：
- 安装 MySQL 客户端。如果已安装 MySQL 客户端则可跳过这一步骤。
```
  yum -y install mysql
```
- 访问 TiDB 数据库，密码为空：
```
  mysql -h 10.0.1.1 -P 4000 -u root
```
- 访问 TiDB 的 Grafana 监控：
  
  通过访问集群 Grafana 监控页面，默认用户名和密码均为 admin。
- 访问 TiDB 的 Dashboard：
  
  通过 http://{pd-ip}:2379/dashboard 访问集群监控页面，默认用户名为 root，密码为空。
- 执行以下命令确认当前已经部署的集群列表：
```
  tiup cluster list
```
- 执行以下命令查看集群的拓扑结构和状态：

如果你刚刚部署好一套 TiDB 本地测试集群：
- 学习 TiDB SQL 操作
如果你准备好在生产环境部署 TiDB 了：
- 在线部署：使用 TiUP 部署 TiDB 集群
如果你想使用 TiFlash 作为数据分析的解决方案，可参阅以下文档：
- 使用 TiFlash

快速上手 TiDB

TiDB 数据库快速上手指南

实施部署