Kubernetes 上的 TiDB 工具指南

本文介绍如何在 Kubernetes 环境中使用 TiDB 相关的工具，包括 PD Control、TiKV Control 和 TiDB Control。

在 Kubernetes 上使用 PD Control

PD Control 是 PD 的命令行工具。在使用 PD Control 操作 Kubernetes 上的 TiDB 集群时，需要先使用 kubectl port-forward 建立本地到 PD 服务的连接：

kubectl port-forward -n ${namespace} svc/${pd_group_name}-pd 2379:2379 &>/tmp/portforward-pd.log &

执行上述命令后，就可以通过 127.0.0.1:2379 访问 PD 服务，从而直接使用 pd-ctl 命令的默认参数执行操作。例如查看 PD 配置：

pd-ctl -d config show

如果本地端口 2379 被占用，你可以指定其他端口：

kubectl port-forward -n ${namespace} svc/${pd_group_name}-pd ${local_port}:2379 &>/tmp/portforward-pd.log &

此时，需要在 pd-ctl 命令中显式指定 PD 端口：

pd-ctl -u 127.0.0.1:${local_port} -d config show

TiKV Control 是 TiKV 的命令行工具。在使用 TiKV Control 操作 Kubernetes 上的 TiDB 集群时，需要先使用 kubectl port-forward 建立本地到 PD 服务以及目标 TiKV 节点的连接。

以下示例将本地 2379 端口转发至 PD 服务：

kubectl port-forward -n ${namespace} svc/${pd_group_name}-pd 2379:2379 &>/tmp/portforward-pd.log &

以下示例将本地 20160 端口转发至目标 TiKV Pod：

kubectl port-forward -n ${namespace} ${pod_name} 20160:20160 &>/tmp/portforward-tikv.log &

建立连接后，即可通过本地的对应端口访问 PD 服务和 TiKV 节点：

tikv-ctl --host 127.0.0.1:20160 --pd 127.0.0.1:2379 ${subcommands}

TiDB Control 是 TiDB 的命令行工具，使用 TiDB Control 时，需要从本地访问 TiDB 节点和 PD 服务，因此建议使用 kubectl port-forward 建立本地到集群中 TiDB 节点和 PD 服务的连接：

以下示例将本地 2379 端口转发至 PD 服务：

kubectl port-forward -n ${namespace} svc/${pd_group_name}-pd 2379:2379 &>/tmp/portforward-pd.log &

以下示例将本地 10080 端口转发至 TiDB Pod：

kubectl port-forward -n ${namespace} ${pod_name} 10080:10080 &>/tmp/portforward-tidb.log &

建立连接后，即可使用 tidb-ctl 执行相关操作。例如，查看 mysql 数据库的 schema：

tidb-ctl schema in mysql