三、Tidb版本升级（tiup）推荐

一、升级 TiUP

1. 先升级 TiUP 版本（建议 tiup 版本不低于 1.5.0）：
tiup update --self
tiup --version
2. 再升级 TiUP Cluster 版本（建议 tiup cluster 版本不低于 1.5.0）：
tiup update cluster
tiup cluster --version

注意：

在升级的过程中不要执行 DDL 请求，否则可能会出现行为未定义的问题。

 

二、编辑 TiUP Cluster 拓扑配置文件

注意：

以下情况可跳过此步骤：

原集群没有修改过配置参数，或通过 tiup cluster 修改过参数但不需要调整。
升级后对未修改过的配置项希望使用 5.2 默认参数。

　

1. 进入拓扑文件的 vi 编辑模式：

tiup cluster edit-config <cluster-name>

 

三、检查当前集群的健康状况

为避免升级过程中出现未定义行为或其他故障，建议在升级前对集群当前的 region 健康状态进行检查，此操作可通过 check 子命令完成。

tiup cluster check <cluster-name> --cluster

 

四、将集群升级到指定版本

升级的方式有两种：不停机升级和停机升级。TiUP Cluster 默认的升级 TiDB 集群的方式是不停机升级，即升级过程中集群仍然可以对外提供服务。升级时会对各节点逐个迁移 leader 后再升级和重启，因此对于大规模集群需要较长时间才能完成整个升级操作。如果业务有维护窗口可供数据库停机维护，则可以使用停机升级的方式快速进行升级操作。

tiup cluster upgrade <cluster-name> <version>

以升级到 5.2.1 版本为例：

tiup cluster upgrade <cluster-name> v5.2.1

 

五、升级后验证

执行 display 命令来查看最新的集群版本 TiDB Version
tiup cluster display <cluster-name>