运维管理
版本升级（检查项和操作步骤，检查项检索方法）
升级前置步骤
| 序号 | 前置步骤项 | 前置步骤目的 | 前置步骤描述 | 参考文档 |
| 1 | variables 系统变量比对 | 检查数据库 variables 系统变量升级前后的差异性 | 测试环境输出升级前和升级后的 variables 差异，以便评估升级后如何做 variables 的版本标准化。 | 【升级指南】TiDB 集群升级标准操作步骤，从v6.5升级到 v8.5.x |
| 2 | config 集群参数比对 | 检查数据库 config 集群参数升级前后的差异性 | 测试环境输出升级前和升级后的 config 差异，以便评估升级后如何做 config 的版本标准化。 | |
| 3 | 应用兼容性 | 应用兼容性的检查 | 需准备测试环境、准生产环境、或者生产备库，运维人员配合应用人员做回归测试。 | |
| 4 | 集群巡检 | 集群健康巡检 | 使用脚本或工具巡检主机与数据库健康。 | |
| 5 | Patch 补丁检查 | 确认目标版本包含所有必要的 Bug 修复和新特性 | 查阅官方 Release Notes ，核对目标版本修复的关键 Bug 及新增特性，确保满足生产环境要求。 | |
| 6 | 业务性能压测 | 主要确保升级后性能没有回退 | 业务侧在测试环境或准生产环境做业务性能压测。 运维侧搭建相关环境集群和配置参数，配合处理业务压测期间遇到的问题，优化SQL等。 | |
| 7 | 升级时长与窗口评估 | 评估在线滚动升级对业务的影响，并确定最佳执行时间段 | 升级需要选择业务低峰，收集监控历史升级过程中的 QPS/延迟波动信息； 根据组件数量保守的估算总耗时：TiDB ≈1 min/节点，TiKV ≈5 min/节点，PD * 3节点 ≈5 min； 由上述数据辅助下，运维人员与应用侧沟通升级变更窗口。 | |
| 8 | DDL 变更与窗口评估 | 确保升级期间无结构变更干扰，避免不确定风险 | 与业务侧确认，升级窗口内禁止 DDL，或提前完成必要的表结构变更。 | |
| 9 | 软件包准备 | 升级包与工具准备 | 确认软件包版本已上传至中控机； 确认 tiup 和 tiup cluster 版本满足升级需求。 | |
| 10 | 备份 | 数据与配置备份 | 备份集群数据（如需）； 系统变量（variables）、集群参数（config）备份； SPM (global bindings) 配置备份； 序列 (sequence) 备份； 视图 (views) 备份； 用户权限备份； meta.yaml 文件备份； 组件版本信息备份； PD ctl 配置信息备份; client host 信息备份; |
原地升级步骤
🔔 原地升级，不支持升级后不支持回退至旧版本，各版本之间的兼容性和参数的配置要求请参阅相关版本的官方版本发布历史，并按文档要求提前检查与调整。因此强烈建议在选择原地升级方案的情况，先在备库实施。
| 序号 | 阶段 | 操作说明 | 操作简要 | 参考文档 |
| 1 | 升级中 | 屏蔽告警 | 登陆 alertmanager 页面，点击“New Silence”，按之前评估的变更时间窗口屏蔽告警。 | 【升级指南】TiDB 集群升级标准操作步骤，从v6.5升级到 v8.5.x |
| 2 | 升级中 | 按版本最佳实践调整 config 参数 | tiup cluster edit-config <cluster-name>，按版本最佳实践微调整 config 参数 | |
| 3 | 升级中 | 本地升级ONLINE | tiup cluster upgrade <cluster_name> v6.5.12 --transfer-timeout 3600 --wait-timeout 3600 | |
| 4 | 升级中/升级后 | 检查 TiDB QPS 与 P99 延迟、PD Leader 分布等 | 登陆 grafana，检查对应的监控面板 | |
| 5 | 升级后 | 核对版本信息 | select type,version,git_hash from INFORMATION_SCHEMA.CLUSTER_INFO ; | |
| 6 | 升级后 | 按版本最佳实践调整 variables | set global xx | |
| 7 | 升级后 | 人工检查，最重点的是日志信息有误异常、grafana 监控的 Failed Query OPM 等指标。 | 登陆 dashboard ，检查对应的面板 |
迁移升级步骤
| 序号 | 阶段 | 操作说明 | 操作简要 | 参考文档 |
| 1 | 升级前 | 前期准备 | 搭建备库，扩容 cdc 并配置实时同步。 | 【升级指南】TiDB 集群升级标准操作步骤，从v6.5升级到 v8.5.x |
| 2 | 升级中 | 屏蔽告警 | 应用侧和运维侧均屏蔽相关的告警。 | |
| 3 | 升级中 | 停止应用并将VIP指向 TiDB | 停止应用并修改连接串指向新的 TiDB 集群。 F5地址：xxx 域名：xxx 端口：4000 | |
| 4 | 升级中 | 主备环境数据一致性校验 | sync_diff_inspector 比数工具做数据一致性校验。 | |
| 5 | 升级中 | 启动应用 | 应用侧人员启动应用。 | |
| 6 | 升级后 | 核心业务验证 & 集群监控 | 应用侧与运维侧人员共同监控业务运行状态。 | |
| 7 | 升级后 | 部署反向数据同步 | 备库搭建反向同步链路至主库。 | |
| 8 | 回退（如需） | 回退到旧版本 | 停应用，断开反向同步链路，应用切到主库（原集群），启动应用。 |