Tikv、Tidb 简单部署及 cpp client 快速上手

测试环境部署

TiDB 是一个分布式系统。最基础的 TiDB 测试集群通常由 2 个 TiDB 实例、3 个 TiKV 实例、3 个 PD 实例和可选的 TiFlash 实例构成。通过 TiUP Playground，可以快速搭建出上述的一套基础测试集群，如果你只想操作 tikv 的话，可以设置相应的参数，不构建 TiDB 实例，具体看后续参数的设置。步骤如下：

1.下载并安装 TiUP

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

安装完的信息

Successfully set mirror to https://tiup-mirrors.pingcap.com
Detected shell: bash
Shell profile:  /home/user/.bashrc
/home/user/.bashrc has been modified to add tiup to PATH
open a new terminal or source /home/user/.bashrc to use it
Installed path: /home/user/.tiup/bin/tiup
===============================================
Have a try:     tiup playground
===============================================

2.声明全局环境变量

source ${your_shell_profile}
#我的系统是 source .profile

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

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

tiup playground

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

tiup playground v6.3.0 --db 2 --pd 3 --kv 3

上述命令会在本地下载并启动某个版本的集群（例如 v6.3.0）。最新版本可以通过执行 tiup list tidb 来查看。运行结果将显示集群的访问方式：

​CLUSTER START SUCCESSFULLY, Enjoy it ^-^
To connect TiDB: mysql --comments --host 127.0.0.1 --port 4001 -u root -p (no password)
To connect TiDB: mysql --comments --host 127.0.0.1 --port 4000 -u root -p (no password)
To view the dashboard: http://127.0.0.1:2379/dashboard
PD client endpoints: [127.0.0.1:2379 127.0.0.1:2382 127.0.0.1:2384]
To view the Prometheus: http://127.0.0.1:9090
To view the Grafana: http://127.0.0.1:3000

注意：

• 支持 v5.2.0 及以上版本的 TiDB 在 Apple M1 芯片的机器上运行 tiup playground。
• 以这种方式执行的 playground，在结束部署测试后 TiUP 会清理掉原集群数据，重新执行该命令后会得到一个全新的集群。
• 若希望持久化数据，可以执行 TiUP 的 --tag 参数：tiup --tag <your-tag> playground ...，详情参考 TiUP 参考手册。

4.新开启一个 session 以访问 TiDB 数据库。

使用 TiUP client 连接 TiDB：tiup client

也可使用 MySQL 客户端连接 TiDB：mysql --host 127.0.0.1 --port 4000 -u root

5.通过 http://127.0.0.1:9090 访问 TiDB 的 Prometheus 管理界面。

6.通过 http://127.0.0.1:2379/dashboard 访问 TiDB Dashboard 页面，默认用户名为 root，密码为空。

7.通过 http://127.0.0.1:3000 访问 TiDB 的 Grafana 界面，默认用户名和密码都为 admin。

8.（可选）将数据加载到 TiFlash 进行分析。

9.测试完成之后，可以通过执行以下步骤来清理集群：

• 按下 Control+C 键停掉上述启用的 TiDB 服务。
• 等待服务退出操作完成后，执行以下命令：tiup clean --all

注意：TiUP Playground 默认监听 127.0.0.1，服务仅本地可访问；若需要使服务可被外部访问，可使用 --host 参数指定监听网卡绑定外部可访问的 IP。

cpp client 快速上手

需要安装 yum install cargo（开发环境缺什么就补什么），并设置环境变量：

echo "export PATH=$PATH:/root/.cargo/bin" >> ~/.bashrc
source ~/.bashrc

接着执行下列操作：

cargo install cxxbridge-cmd --force --version 1.0.18
make

make 后 tikv demo 在 target 目录下，直接运行 tikv-example 体验 tikv。library 路径 target/debug/libtikv_client.a。

注意：cpp client 有很多接口还没有支持，而且目前只支持同步的 API。不过可以写写一些简单的事务 demo，有助于更好理解事务。