平滑升级 TiDB

本文档介绍 TiDB 的平滑升级集群功能,支持无需手动取消 DDL 的操作。

从 v7.1.0 起,当将 TiDB 升级至更高的版本时,TiDB 支持平滑升级功能,取消了升级过程中的限制,提供更平滑的升级体验。此功能默认开启,且无开关控制。

功能简介

TiDB 引入平滑升级功能前,对于升级过程中的 DDL 操作有如下限制(可以参考使用 TiUP 升级 TiDB中警告部分):

  • 在升级过程中执行 DDL 操作,TiDB 可能会出现未定义的行为。
  • 在 DDL 操作执行过程中升级 TiDB,TiDB 可能会出现未定义的行为。

引入平滑升级后,TiDB 升级过程不再受上述限制。

升级过程中,TiDB 会自动进行以下操作,无需用户干预:

  1. 暂停用户的 DDL 操作。
  2. 执行升级过程中的系统 DDL 操作。
  3. 恢复被暂停的用户的 DDL 操作。
  4. 完成升级。

其中,恢复的 DDL job 仍会按升级前的顺序执行。

使用限制

使用平滑升级功能时,需要注意以下限制。

用户操作限制

  • 在升级前,如果集群中存在正在处理的 canceling DDL job,即有正在被处理的 DDL job 被用户取消了,由于处于 canceling 状态的 job 无法被 pause,TiDB 会尝试重试。如果重试失败,会报错并退出升级。

  • 如果 TiDB 分布式执行框架(实验特性)已启用,请关闭 TiDB 分布式执行框架(即将 tidb_enable_dist_task 设置为默认值 OFF),并确保所有分布式 ADD INDEXIMPORT INTO 任务已完成,或者取消这些任务并等待升级完成后重新开始。否则,升级期间的 ADD INDEX 操作可能导致数据索引不一致。

  • 在使用 TiUP 进行升级的场景下,由于 TiUP 升级存在超时时间,如果在升级之前集群中有大量 DDL(超过 300 条)正在处理队列中等待执行,则此次升级可能会失败。

  • 在升级过程中,不允许以下操作:

    • 对系统表(mysql.*information_schema.*performance_schema.*metrics_schema.*)进行 DDL 操作。

    • 执行手动取消 DDL job 操作:ADMIN CANCEL DDL JOBS job_id [, job_id] ...;

    • 导入数据。

工具使用限制

在升级过程中,不支持使用以下工具:

  • BR:BR 可能会将处于 paused 状态的 DDL 拷贝到 TiDB 中,而此状态的 DDL 不能自动 resume,可能导致后续 DDL 卡住的情况。

  • DM 和 TiCDC:如果在升级过程中使用 DM 和 TiCDC 向 TiDB 导入 SQL,并且其中包含 DDL 操作,则该导入操作会被阻塞,并可能出现未定义错误。

文档内容是否有帮助?